Skip to main content

celocli exchange

Exchange Celo Dollars and CELO via Mento

celocli exchange:celo

Exchange CELO for StableTokens via Mento. (Note: this is the equivalent of the old exchange:gold)

USAGE
$ celocli exchange:celo --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --value
10000000000000000000000 [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--forAtLeast 10000000000000000000000] [--stableToken
cUSD|cusd|cEUR|ceur|cREAL|creal]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--forAtLeast=10000000000000000000000
[default: 0] Optional, the minimum value of StableTokens to receive in return

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) The address with CELO to exchange

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--stableToken=<option>
[default: cusd] Name of the stable to receive
<options: cUSD|cusd|cEUR|ceur|cREAL|creal>

--useLedger
Set it to use a ledger wallet

--value=10000000000000000000000
(required) The value of CELO to exchange for a StableToken

DESCRIPTION
Exchange CELO for StableTokens via Mento. (Note: this is the equivalent of the old
exchange:gold)

EXAMPLES
celo --value 5000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d

celo --value 5000000000000 --forAtLeast 100000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --stableToken cStableTokenSymbol

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/exchange/celo.ts

celocli exchange:dollars

Exchange Celo Dollars for CELO via Mento

USAGE
$ celocli exchange:dollars --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --value
10000000000000000000000 [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--forAtLeast 10000000000000000000000]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--forAtLeast=10000000000000000000000
[default: 0] Optional, the minimum value of CELO to receive in return

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) The address with Celo Dollars to exchange

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

--value=10000000000000000000000
(required) The value of Celo Dollars to exchange for CELO

DESCRIPTION
Exchange Celo Dollars for CELO via Mento

EXAMPLES
dollars --value 10000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d

dollars --value 10000000000000 --forAtLeast 50000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/exchange/dollars.ts

celocli exchange:euros

Exchange Celo Euros for CELO via Mento

USAGE
$ celocli exchange:euros --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --value
10000000000000000000000 [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--forAtLeast 10000000000000000000000]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--forAtLeast=10000000000000000000000
[default: 0] Optional, the minimum value of CELO to receive in return

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) The address with Celo Euros to exchange

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

--value=10000000000000000000000
(required) The value of Celo Euros to exchange for CELO

DESCRIPTION
Exchange Celo Euros for CELO via Mento

EXAMPLES
euros --value 10000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d

euros --value 10000000000000 --forAtLeast 50000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/exchange/euros.ts

celocli exchange:reals

Exchange Celo Brazilian Real (cREAL) for CELO via Mento

USAGE
$ celocli exchange:reals --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --value
10000000000000000000000 [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--forAtLeast 10000000000000000000000]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--forAtLeast=10000000000000000000000
[default: 0] Optional, the minimum value of CELO to receive in return

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) The address with Celo Brazilian Real to exchange

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

--value=10000000000000000000000
(required) The value of Celo Brazilian Real to exchange for CELO

DESCRIPTION
Exchange Celo Brazilian Real (cREAL) for CELO via Mento

EXAMPLES
reals --value 10000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d

reals --value 10000000000000 --forAtLeast 50000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/exchange/reals.ts

celocli exchange:show

Show the current exchange rates offered by the Broker

USAGE
$ celocli exchange:show [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--amount <value>]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--amount=<value>
[default: 1000000000000000000] Amount of the token being exchanged to report rates
for

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--useLedger
Set it to use a ledger wallet

DESCRIPTION
Show the current exchange rates offered by the Broker

EXAMPLES
list

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/exchange/show.ts

celocli exchange:stable

Exchange Stable Token for CELO via Mento

USAGE
$ celocli exchange:stable --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --value
10000000000000000000000 [-k <value> | --useLedger | ] [-n <value>] [--gasCurrency
0x1234567890123456789012345678901234567890] [--ledgerAddresses <value> ]
[--globalHelp] [--forAtLeast 10000000000000000000000] [--stableToken
cUSD|cusd|cEUR|ceur|cREAL|creal]

FLAGS
-k, --privateKey=<value>
Use a private key to sign local transactions with

-n, --node=<value>
URL of the node to run commands against or an alias

--forAtLeast=10000000000000000000000
[default: 0] Optional, the minimum value of CELO to receive in return

--from=0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d
(required) The address with the Stable Token to exchange

--gasCurrency=0x1234567890123456789012345678901234567890
Use a specific gas currency for transaction fees (defaults to CELO if no gas
currency is supplied). It must be a whitelisted token.

--globalHelp
View all available global flags

--ledgerAddresses=<value>
[default: 1] If --useLedger is set, this will get the first N addresses for local
signing

--stableToken=<option>
Name of the stable token to be transferred
<options: cUSD|cusd|cEUR|ceur|cREAL|creal>

--useLedger
Set it to use a ledger wallet

--value=10000000000000000000000
(required) The value of Stable Tokens to exchange for CELO

DESCRIPTION
Exchange Stable Token for CELO via Mento

EXAMPLES
stable --value 10000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --stableToken cStableTokenSymbol

stable --value 10000000000000 --forAtLeast 50000000000000 --from 0xc1912fEE45d61C87Cc5EA59DaE31190FFFFf232d --stableToken cStableTokenSymbol

FLAG DESCRIPTIONS
-n, --node=<value> URL of the node to run commands against or an alias

Can be a full url like https://forno.celo.org or an alias. default:
http://localhost:8545
Alias options:
local, localhost => 'http://localhost:8545'
alfajores => Celo Alfajores Testnet,
mainnet, celo, forno => Celo Mainnet chain',

See code: src/commands/exchange/stable.ts