Submitting transaction

If you are using the web3 SDK in JavaScript, signing looks like this:

import { PrivateKeyWallet } from "@alephium/web3-wallet";

const wallet = new PrivateKeyWallet({ privateKey: "your-private-key" });
const signature = await wallet.signRaw("503bfb16...");

Step 3: Submit the signed transaction

curl -X POST "https://rpc.ralphstudio.xyz/{your-slug}/transactions/submit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "unsignedTx": "0201010...long hex string...",
    "signature": "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
  }'

{
  "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
  "fromGroup": 0,
  "toGroup": 0
}

The returned txId matches what you got in step 1. The transaction is now in the mempool.

Step 4: Check transaction status

Poll this endpoint until type is "Confirmed":

curl "https://rpc.ralphstudio.xyz/{your-slug}/transactions/status?txId=503bfb16...&fromGroup=0&toGroup=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

While pending:

{
  "type": "MemPooled"
}

Once confirmed:

{
  "type": "Confirmed",
  "blockHash": "00000000ab3c...",
  "txIndex": 1,
  "chainConfirmations": 1,
  "fromGroupConfirmations": 1,
  "toGroupConfirmations": 1
}

If not found:

{
  "type": "TxNotFound"
}

For most use cases 1 confirmation is sufficient. For high-value transfers wait for at least 110 confirmations (~2 hours): this is the Alephium recommendation for exchanges and large amounts.

Sending tokens alongside ALPH

To include a token in the transfer add a tokens array to the destination. Every output on Alephium must include a minimum ALPH amount (dust) even when the primary transfer is a token:

curl -X POST "https://rpc.ralphstudio.xyz/{your-slug}/transactions/build" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromPublicKey": "03a6b9c2d4e5f1...",
    "destinations": [
      {
        "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
        "attoAlphAmount": "1000000000000000",
        "tokens": [
          {
            "id": "b2d71c116408ae47a83c6db0571a1b2d1f58dc87ac5d7e8e4c2a3d1f9e0b8c4",
            "amount": "500000000"
          }
        ]
      }
    ]
  }'

1000000000000000 attoALPH (0.001 ALPH) is the typical dust minimum. The node will reject outputs below this threshold.

Sweep all ALPH from an address

To empty an address completely use the sweep endpoint it automatically calculates the correct amount after gas:

curl -X POST "https://rpc.ralphstudio.xyz/{your-slug}/transactions/sweep-address/build" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromPublicKey": "03a6b9c2d4e5f1...",
    "toAddress": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
  }'

{
  "unsignedTxs": [
    {
      "txId": "...",
      "unsignedTx": "..."
    }
  ]
}

Note that sweep returns an array of unsigned transactions if the address has many UTXOs the node may split it into multiple transactions. Sign and submit each one individually.

Decode a transaction before signing

If you want to inspect what a transaction does before signing it:

curl -X POST "https://rpc.ralphstudio.xyz/{your-slug}/transactions/decode-unsigned-tx" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "unsignedTx": "0201010...long hex string..."
  }'

{
  "unsignedTx": {
    "txId": "503bfb16...",
    "version": 1,
    "networkId": 0,
    "gasAmount": 20000,
    "gasPrice": "100000000000",
    "inputs": [...],
    "fixedOutputs": [...]
  }
}

Always decode and verify fixedOutputs matches your expectations before signing, especially when building transactions programmatically.

Parameters reference

Field	Type	Description
fromPublicKey	string	Hex-encoded 33-byte compressed public key of the sender
destinations	array	List of recipient objects
address	string	Recipient base58 address
attoAlphAmount	string	Amount in attoALPH as a string integer
tokens	array	Optional list of token transfers `{ id, amount }`
gasAmount	integer	Optional: node estimates if omitted
gasPrice	string	Optional: node uses default if omitted

Guides

Step 3: Submit the signed transaction

Step 4: Check transaction status

Sending tokens alongside ALPH

Sweep all ALPH from an address

Decode a transaction before signing

Parameters reference

Next steps

Read a contract

Error handling

​Step 3: Submit the signed transaction

​Step 4: Check transaction status

​Sending tokens alongside ALPH

​Sweep all ALPH from an address

​Decode a transaction before signing

​Parameters reference

​Next steps

Read a contract

Error handling

Step 3: Submit the signed transaction

Step 4: Check transaction status

Sending tokens alongside ALPH

Sweep all ALPH from an address

Decode a transaction before signing

Parameters reference

Next steps