Transactions - Ralph Studio

Alephium transactions go through three steps build, sign, submit. The node handles building and submitting. Signing happens client-side with the sender’s private key, typically through the Alephium SDK or wallet.

Get transaction status

Returns the current status of a transaction by its hash.

curl "https://rpc.ralphstudio.xyz/{slug}/transactions/status?txId={tx-hash}&fromGroup=0&toGroup=0" \
  -H "Authorization: Bearer API_KEY"

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

The type field can be Confirmed, MemPooled, or TxNotFound.

Get transaction details

Returns full transaction data by hash.

curl "https://rpc.ralphstudio.xyz/{slug}/transactions/details/{tx-hash}?fromGroup=0&toGroup=0" \
  -H "Authorization: Bearer API_KEY"

{
  "unsigned": {
    "txId": "503a2c...",
    "version": 0,
    "networkId": 0,
    "gasAmount": 20000,
    "gasPrice": "100000000000",
    "inputs": [...],
    "fixedOutputs": [...]
  },
  "contractInputs": [],
  "generatedOutputs": [],
  "inputSignatures": [...],
  "scriptSignatures": []
}

Build a transaction

Builds an unsigned transaction. The response contains the unsigned tx that needs to be signed before submitting.

curl -X POST "https://rpc.ralphstudio.xyz/{slug}/transactions/build" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromPublicKey": "03a1b2c3...",
    "destinations": [
      {
        "address": "1DrDyTr9RpRsQnDnXo2YRiPzPW4ooHX5LLoqXrqfMrpQH",
        "attoAlphAmount": "1000000000000000000"
      }
    ]
  }'

{
  "unsignedTx": "0000000000...",
  "gasAmount": 20000,
  "gasPrice": "100000000000",
  "txId": "503a2c...",
  "fromGroup": 0,
  "toGroup": 0
}

Submit a signed transaction

Submits a transaction that has already been signed.

curl -X POST "https://rpc.ralphstudio.xyz/{slug}/transactions/submit" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "unsignedTx": "0000000000...",
    "signature": "a1b2c3d4..."
  }'

{
  "txId": "503a2c...",
  "fromGroup": 0,
  "toGroup": 0
}

Decode an unsigned transaction

Decodes a raw unsigned transaction into a human-readable format.

curl -X POST "https://rpc.ralphstudio.xyz/{slug}/transactions/decode-unsigned-tx" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "unsignedTx": "0000000000..."
  }'

Sweep address

Consolidates all UTXOs from an address into a single output. Useful for cleaning up fragmented balances.

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

Estimate gas

Returns the estimated gas for a transaction before building it.

curl -X POST "https://rpc.ralphstudio.xyz/{slug}/transactions/build" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fromPublicKey": "03a1b2c3...",
    "destinations": [...],
    "gasAmount": null
  }'

When gasAmount is null the node estimates it automatically and includes the estimate in the response.

Parameters reference

Parameter	Type	Description
txId	string	Transaction hash
fromGroup	integer	Source shard group (0–3)
toGroup	integer	Destination shard group (0–3)
fromPublicKey	string	Sender’s public key (hex)
destinations	array	List of recipient addresses and amounts
attoAlphAmount	string	Amount in attoALPH (1 ALPH = 10^18 attoALPH)
unsignedTx	string	Raw unsigned transaction (hex)
signature	string	Transaction signature (hex)
gasAmount	integer	Gas limit: leave null to auto-estimate
gasPrice	string	Gas price in attoALPH

​Get transaction status

​Get transaction details

​Build a transaction

​Submit a signed transaction

​Decode an unsigned transaction

​Sweep address

​Estimate gas

​Parameters reference