Broadcast a signed transaction from a Dynamic v3 WaaS wallet

Relays an already-signed transaction from a Dynamic v3 WaaS wallet to the network. The server derives chain and wallet address from walletId, verifies the signed payload belongs to the wallet, owns provider selection and bounded retry/failover of the identical signed bytes, and replays a stored result when x-idempotency-key repeats. Replacement or speed-up transactions use different signed bytes and require a new key; reusing an existing key with different bytes returns 409.

POST /sdk/{environmentId}/waas/{walletId}/transactions/broadcast

Broadcast a signed transaction from a Dynamic v3 WaaS wallet

cURL

curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/waas/{walletId}/transactions/broadcast \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "networkId": "<string>",
  "signedTransaction": "<string>",
  "signatures": [
    "<string>"
  ],
  "options": {
    "skipPreflight": true
  }
}
'

200

{
  "attempts": 123,
  "broadcastId": "<string>",
  "status": "submitted",
  "transactionId": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-idempotency-key · string · required

Idempotency key scoping a broadcast result. Replaying the same key with the identical signed payload returns the stored result. Replacement or speed-up transactions use different signed bytes and require a new key; reusing an existing key with different bytes returns 409.

Required string length: 1 - 255

Pattern: ^[-A-Za-z0-9._~!$&'()*+,;=:@/]{1,255}$

Path Parameters

environmentId · string · required

ID of the environment

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

walletId · string · required

UUID of the wallet

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

Signed transaction broadcast request

encoding · enum<string> · required

Wire encoding of the signed transaction payload.

Available options: hex, base64, xdr, json

networkId · string · required

Network identifier the transaction targets (e.g. "1", "101").

Pattern: ^[0-9]{1,20}$

signedTransaction · string · required

Immutable signed transaction payload, encoded per encoding.

Maximum string length: 204800

signatures · string[]

Detached signatures for chains whose wire format carries them separately from the serialized message.

Maximum array length: 32

A string with a max length of 204800 characters

Maximum string length: 204800

options · object

Optional chain-specific submission options, validated server-side.

Show child attributes

Response

200

application/json

Transaction submitted or already known to the network

attempts · integer · required

Number of submission attempts made before resolving.

broadcastId · string · required

Server-generated identifier for this broadcast operation.

status · enum<string> · required

Terminal broadcast outcome.

Available options: submitted, already_known

transactionId · string · required

Chain transaction identifier (EVM hash, Solana signature).