Ell

ell_send

Send a transaction. Send ELL from one account to another account.

Private: Requires authentication.

Curl Example:

curl \ 
    -H "Authorization: Bearer xxxx.fQ.bk6c9uBbEUBDAwnPY_Gs5p7m4zgwY" 
    -X POST \
    127.0.0.1:8987 \
    --data '{"jsonrpc":"2.0",
                "method":"ell_send", 
                "params": { 
                    "fee":"0.01",
                    "from":"e2MhrMh7xvpByj3G3pKdHPfwFfNS7yRaRx",
                    "hash":"0x073a2bca8dbbac9b2dff4020314d53faa18f0530fa1c57ae9d8a7355317cda93",
                    "nonce":22,
                    "senderPubKey":"49EqPSyUhz8XnQfPajpFthKKkFUevM5CV13VgjRu8TAY9sgeYD2",
                    "sig":"0xa2cdbed94b8a30563a92fe038a112a232c68a68a06fd161b7335a635960e26bbff2b7a28b691a56b906f62738c44907a9598dd08dfa02afe0356cacab6647704",
                    "timestamp":1541769498,
                    "to":"e2Zs2nsmocrQcE1tPyVgm4deVSVVYppxum",
                    "type":1,
                    "value":"1"} , 
                "id":21}'

Console Example

> ell.send({
  "fee": "0.01",
  "from": "e2MhrMh7xvpByj3G3pKdHPfwFfNS7yRaRx",
  "hash": "0x073a2bca8dbbac9b2dff4020314d53faa18f0530fa1c57ae9d8a7355317cda93",
  "nonce": 22,
  "senderPubKey": "49EqPSyUhz8XnQfPajpFthKKkFUevM5CV13VgjRu8TAY9sgeYD2",
  "sig": "0xa2cdbed94b8a30563a92fe038a112a232c68a68a06fd161b7335a635960e26bbff2b7a28b691a56b906f62738c44907a9598dd08dfa02afe0356cacab6647704",
  "timestamp": 1541769498,
  "to": "e2Zs2nsmocrQcE1tPyVgm4deVSVVYppxum",
  "type": 1,
  "value": "1"
})

Console Example (Using Transaction Builder)

> ell.balance().
    senderPubKey("49EqPSyUhz8XnQfPajpFthKKkFUevM5CV13VgjRu8TAY9sgeYD2").
    from("e2MAm5dZS9biD31gENCoqTQd8DeTMrxoEo").
    to("e2Zs2nsmocrQcE1tPyVgm4deVSVVYppxum").
    value("1").
    fee("0.01").
    nonce("1").
    send()

By default, when from() is not called, the address of the loaded account is used.

By default, then senderPubKey() is not called, the public key of the loaded account is used.

Calling nonce() is optional. The current sender account's nonce will be automatically determined and set.

Returns:

Object

Field

Type

Description

id

String

The transaction hash

Output:

{
  "id": 21,
  "jsonrpc": "2.0",
  "result": {
    "id": "0xe6167c8d32ca075eb2c5bbc6e87d9941bf4b2e564e85d0c447d91e98dd0bef2e"
  }
}

ell.balance

Returns a transaction builder that can be used to create a balance transaction using chain-able methods interface. The transaction builder calls ell_send when the built transaction is ready to be sent to the node.

Create a new builder

> var myBuilder = ell.balance()

Transaction Builder Methods

The build is an object that includes methods required to conveniently construct and sign a full transaction. These are the available methods:

Method

Argument Type

Return Type

Required

Description

senderPubKey

String

TxBuilder

False

Set the public key of the sender/signer. (Default: Public key of the loaded account)

from

String

TxBuilder

False

Set the sender's address. (Default: Address of the loaded account)

to

String

TxBuilder

True

The recipients address.

value

String

TxBuilder

True

The amount of ELL to send.

fee

String

TxBuilder

True

The amount of fee to pay.

nonce

String

TxBuilder

False

The next nonce of the account (current nonce + 1).

send

Finalizes and sends the transaction.

payload

Boolean

Returns the internal transaction that's being built.

packed

Base58Check

String

Finalizes and returns Base58 encoded version of the transaction

reset

Clears all collected data. Restore the builder to its zero state.

Full Console Example

> ell.balance().
    senderPubKey("49EqPSyUhz8XnQfPajpFthKKkFUevM5CV13VgjRu8TAY9sgeYD2").
    from("e2MAm5dZS9biD31gENCoqTQd8DeTMrxoEo").
    to("e2Zs2nsmocrQcE1tPyVgm4deVSVVYppxum").
    value("1").
    fee("0.01").
    nonce("1").
    send() // or payload() or packed(true)

Whenfrom()is not called, the address of the loaded account is used.

WhensenderPubKey()is not called, the public key of the loaded account is used.

Calling nonce() is optional. The current sender account's nonce will be automatically determined and set.

By default, the transaction type is set to 1 = Balance Transaction.

Returns:

Object

Field

Type

Description

id

String

The transaction hash

Output:

{
  "id": 21,
  "jsonrpc": "2.0",
  "result": {
    "id": "0xe6167c8d32ca075eb2c5bbc6e87d9941bf4b2e564e85d0c447d91e98dd0bef2e"
  }
}

ell_getBalance

Get the ELL balance of an account.

Parameters:

Argument

Type

Required

Description

address

String

True

The address of the account.

Curl Example:

curl -X POST --data '{"jsonrpc":"2.0","method":"ell_getBalance", "params": "e2MhrMh7xvpByj3G3pKdHPfwFfNS7yRaRx", "id":21}'

Console Example

> ell.getBalance("e2MhrMh7xvpByj3G3pKdHPfwFfNS7yRaRx")

Returns:

String

Output:

{
  "id": 21,
  "jsonrpc": "2.0",
  "result": "100.000000000000000000"
}

ell_sendRaw

Send a base58 encoded transaction to the client for processing.

Parameters:

Argument

Type

Required

Description

encodedTx

String

True

The base58 encoded transaction

Curl Example:

curl -X POST --data '{"jsonrpc":"2.0","method":"ell_sendRaw", "params": "2ZRcZJ4LGqyMBEuAD8Cspa9h3sAoAs6vgifKEXM...ZXd9ubdWgBCkjCLewqu", "id":21}'

Console Example

> ell.sendRaw("2ZRcZJ4LGqyMBEuAD8Cspa9h3sAoAs6vgifKEXM1BSRtz" + 
                 "v2C5gshUL15zuv2x4FLDY9DywEMMLZKDWe3gUgAUWQnsfib" + 
                 "bRywBur4WApyZmBsZNjayy6zft6JnUjzv5XRbUe2UzvCwKkeRQ" + 
                 "r686p4zutSCjTK4L3cqp7Gv1LaiZT8WwdCr6ZcXxTkUPeoZyq2paZ" + 
                 "E856e27iqTWdecbeoEeR1UqK7RZZdqqJafYuUq8XaJ3MkqNznT2eD" + 
                 "jEmnwQhRH2WHCHGuCMdZHQUZ6WK7J9sgB9GoWgy3K3Q459JpjxFNw" +
                 "zJErVqnmnazZwdqmtCK5zq4kfXj9AbL86zxeKFx7xiN87raXJ6oWAQL" + 
                 "GYAphTSuWG1FgBy4d7SyUrDuDHfZwLeMPE2RZxCeHUGUrgpkiofPPpeb" + 
                 "p5SXeJiaTvJRAGntJgEXEpDBFxTpKxhaDZn1AUcYohyPXg71pCvuTc7sa" + 
                 "CmtFgWzWrQKfWXDKYeJF5RCA8LyQ4LRVheQuPTQXbQNDkcynGdkVZ2zuZLp" +
                 "qJhoFoeYrnB8u5bxzKoo4BiFfKjLVSh1RRuEZ2XzJRPKaqHYL9xBGA2cB2U6Z" +
                 "Xd9ubdWgBCkjCLewqu")

Returns:

Object

Field

Type

Description

id

String

The transaction hash

Output:

{
  "id": 21,
  "jsonrpc": "2.0",
  "result": {
    "id": "0xe6167c8d32ca075eb2c5bbc6e87d9941bf4b2e564e85d0c447d91e98dd0bef2e"
  }
}

Last updated