Skip to main content
POST
Error

Authorizations

aura_session
string
cookie
required

HttpOnly session cookie set by POST /v1/auth/session. Mutating requests must also send the CSRF token (returned by that call) in the x-csrf-token header.

Body

application/json
signerAddress
string
required

Alephium address (base58, optional :N group suffix).

Required string length: 30 - 80
Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$
signerPublicKey
string
required

Signer's public key (33-byte secp256k1 hex). Required for the node to build the witness layout.

Pattern: ^(0x)?[0-9a-fA-F]+$
masterId
integer
required
Required range: 0 <= x <= 9007199254740991
linkedIds
integer[]
required

On-chain proposal ids of the sibling legs (the api canonically encodes them).

Required array length: 1 - 99 elements
Required range: 0 <= x <= 9007199254740991
masterQuestion
string
required
Required string length: 1 - 300
masterImageUrl
string
required
Maximum string length: 500
signerKeyType
enum<string>
default:default

Signature scheme the signer address was derived from. gl-secp256k1 is the groupless key the Aura app uses (3... addresses); default is grouped secp256k1 for standard Alephium wallets and tooling (1... addresses). These are the only two types a session can be established with, so no other value can reach a build-tx route.

Available options:
default,
gl-secp256k1

Response

Default Response

unsignedTx
string
required

Hex-encoded unsigned transaction. Sign and submit via your wallet.

txId
string
required
fromGroup
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
toGroup
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
gasAmount
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
gasPrice
string
required
attoAlphAmount
string
tokens
object[]
collateralRequired
string
Last modified on July 29, 2026