Skip to main content

transfer

Description

Transfer tokens from account to account

Positional Parameters

  • sender TEXT - The account sending EOS
  • recipient TEXT - The account receiving EOS
  • amount UINT - The amount of EOS to send
  • memo TEXT - The memo for the transfer

Options

  • -c,--contract TEXT - The contract which controls the token
  • --pay-ram-to-open - Pay ram to open recipient's token balance row
  • -x,--expiration - set the time in seconds before a transaction expires, defaults to 30s
  • -f,--force-unique - force the transaction to be unique. this will consume extra bandwidth and remove any protections against accidently issuing the same transaction multiple times
  • -s,--skip-sign - Specify if unlocked wallet keys should be used to sign transaction
  • -j,--json - print result as json
  • --json-file TEXT - save result in json format into a file
  • -d,--dont-broadcast - don't broadcast transaction to the network (just print to stdout)
  • --return-packed - used in conjunction with --dont-broadcast to get the packed transaction
  • -r,--ref-block TEXT - set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
  • --use-old-rpc - use old RPC push_transaction, rather than new RPC send_transaction
  • -p,--permission TEXT ... - An account and permission level to authorize, as in 'account@permission' (defaults to 'sender@active')
  • --max-cpu-usage-ms UINT - set an upper limit on the milliseconds of cpu usage budget, for the execution of the transaction (defaults to 0 which means no limit)
  • --max-net-usage UINT - set an upper limit on the net usage budget, in bytes, for the transaction (defaults to 0 which means no limit)
  • --delay-sec UINT - set the delay_sec seconds, defaults to 0s

Example

Transfer 1000 SYS from inita to tester

cleos transfer inita tester 1000

The response should look something like this:

{
"transaction_id": "eb4b94b72718a369af09eb2e7885b3f494dd1d8a20278a6634611d5edd76b703",
"processed": {
"refBlockNum": 2206,
"refBlockPrefix": 221394282,
"expiration": "2017-09-05T08:03:58",
"scope": [
"inita",
"tester"
],
"signatures": [
"1f22e64240e1e479eee6ccbbd79a29f1a6eb6020384b4cca1a958e7c708d3e562009ae6e60afac96f9a3b89d729a50cd5a7b5a7a647540ba1678831bf970e83312"
],
"messages": [{
"code": "eos",
"type": "transfer",
"authorization": [{
"account": "inita",
"permission": "active"
}
],
"data": {
"from": "inita",
"to": "tester",
"amount": 1000,
"memo": ""
},
"hex_data": "000000008040934b00000000c84267a1e80300000000000000"
}
],
"output": [{
"notify": [{
"name": "tester",
"output": { ... }
},{
"name": "inita",
"output": { ... }
}
],
"sync_transactions": [],
"async_transactions": []
}
]
}
}