Solana transactions

Transaction

Signs an unsigned transaction and broadcasts it to chain.

Field	Description	Type - Optional
`kind`	`Transaction`	String
`transaction`	The unsigned hex encoded transaction as shown below	String
`externalId`	A unique ID from your system. It can be leveraged to be used as an idempotency key (see Idempotency).	String (optional)

{
  "kind": "Transaction",
  "transaction": "0x01000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008001000103b25c8c464080ab2835a166d2b3f13195c2ff3c8f281c7ebe492f0d45d830ff4824a8b38a94b73d2756f2be68655a49706be9b1dc900978984d6eeaf65ab62e900000000000000000000000000000000000000000000000000000000000000000280c73cfb9caeb41b8508d20057917b568ac1f5a4175b5befa94532b3fd0b92e01020200010c02000000010000000000000000"
}

Solana web3.js expects the serialized transaction to include 0-padded placeholder signatures, otherwise deserialization will failed. If you are using a different library to construct the serialized transaction, such as the Go SDK, please make sure to include the placeholder signatures.

Typescript Example with Solana web3.js

First install the Solana web3.js SDK. You can find the full documentation here. Here a code sample to broadcast a transaction via the DFNS TypeScript SDK:

import {
  clusterApiUrl,
  Connection,
  PublicKey,
  SystemProgram,
  TransactionMessage,
  VersionedTransaction,
} from '@solana/web3.js'

const walletId = 'wa-6lbfv-9esgj-xxxxxxxxxxxxxxxx'
const wallet = await dfnsClient.wallets.getWallet({ walletId })

const myAddress = new PublicKey(wallet.address)
const toAddress = new PublicKey('3U6stgsD1FmA7o3omUguritCU8iWmUM7Rs6KqAHHxHVZ')

const connection = new Connection(clusterApiUrl('devnet'), 'confirmed')
const latestBlockhash = await connection.getLatestBlockhash()

const message = new TransactionMessage({
  payerKey: myAddress,
  recentBlockhash: latestBlockhash.blockhash,
  instructions: [
    SystemProgram.transfer({
      fromPubkey: myAddress,
      toPubkey: toAddress,
      lamports: 1n,
    }),
  ],
}).compileToV0Message()
const transaction = new VersionedTransaction(message)

const res = await dfnsClient.wallets.broadcastTransaction({
  walletId,
  body: {
    kind: 'Transaction',
    transaction: `0x${Buffer.from(transaction.serialize()).toString('hex')}`,
  },
})

Durable nonce transactions

A signed Solana transaction normally expires when its recent blockhash does (about 90 seconds). To keep a signed transaction valid indefinitely — for offline signing, or when a policy approval sits between signing and broadcast — build it against a durable nonce instead of a recent blockhash. For plain SOL and SPL transfers, the simplest path is the DFNS-managed nonce pool: bootstrap it once with the CreateSolanaNonceAccounts transaction kind, then set useDurableNonce: true on the transfer and DFNS picks and advances a nonce for you. To use a durable nonce on an arbitrary transaction you build yourself, manage the nonce account through Sign and Broadcast:

Create a nonce account owned by your wallet with SystemProgram.createAccountWithSeed + SystemProgram.nonceInitialize, then sign and broadcast it. Deriving the address from the wallet (createWithSeed) keeps the wallet as the only required signer.
Use it: set the transaction’s recentBlockhash to the nonce account’s current nonce value, and make SystemProgram.nonceAdvance the first instruction. Sign and broadcast, wait for confirmation, then re-read the nonce value before the next transaction — each executed transaction advances it.
Destroy it when done with SystemProgram.nonceWithdraw, which closes the account and reclaims the rent. There is no dedicated close transaction kind; the withdraw instruction does it.

Use a seed you control (for example my-app/nonce/0), distinct from the pool’s nonce/<index> seeds, so a self-managed account and a pool account can never pick the same nonce. See the full runnable example: durable-nonce-tx. For the dashboard and pool-based flow, see Use Solana durable nonces.

Complete examples

For complete working examples, see the SDK examples on GitHub:

Basic transaction - Simple SOL transfer
Durable nonce transaction - Transaction with durable nonce for replay protection
Mint creation - SPL token minting
Staking - SOL staking operations

API Authorization

Identity & Access Management

Wallets & Transactions

Management

Webhooks

Transaction

Typescript Example with Solana web3.js

Durable nonce transactions

Complete examples

​Transaction

​Typescript Example with Solana web3.js

​Durable nonce transactions

​Complete examples

Transaction

Typescript Example with Solana web3.js

Durable nonce transactions

Complete examples