unsafe_mergeCoins

Transaction Builder API

Create an unsigned transaction to merge multiple coins into one coin.

Parameters

• signer · SuiAddress · requiredthe transaction signer's Sui address
• primary_coin · ObjectID · requiredthe coin object to merge into, this coin will remain after the transaction
• coin_to_merge · ObjectID · requiredthe coin object to be merged, this coin will be destroyed, the balance will be added to primary_coin
• gas · ObjectID · optionalgas object to be used in this transaction, node will pick one from the signer's possession if not provided
• gas_budget · BigInt<u64> · requiredthe gas budget, the transaction will fail if the gas cost exceed the budget

Result

• TransactionBlockBytes · TransactionBlockBytes

  • gas · ObjectRef[] · requiredthe gas objects to be used
  • inputObjects · InputObjectKind[] · requiredobjects to be used in this transaction
  • txBytes · Base64 · requiredBCS serialized transaction data bytes without its type tag, as base-64 encoded string.

Example

Replace each <param> with a value of the type listed under Parameters.

Request

curl https://mainnet-api.inodra.com/v1/jsonrpc \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "unsafe_mergeCoins",
  "params": [
    "<signer>",
    "<primary_coin>",
    "<coin_to_merge>",
    "<gas_budget>"
  ]
}'