Transaction Operations
resource: transaction — look up a transaction, or send a native SOL transfer
get
Returns a transaction's status, fee, and program logs by signature. Read-only, no credential.
| Field | Type | Required | Description |
|---|---|---|---|
signature | text | ✓ Yes | Base58 transaction signature. |
cluster | select | No | See Clusters. Defaults to Solana:DefaultCluster. |
Example response:
{
"signature": "5j7s...Xy2",
"slot": 301458219,
"blockTime": "1706000000",
"fee": 5000,
"err": "",
"logs": ["Program 11111111111111111111111111111111 invoke [1]", "Program 11111111111111111111111111111111 success"]
}
| Response Field | Meaning |
|---|---|
blockTime | Unix timestamp (as text) the block was produced, empty if unavailable. |
fee | Transaction fee in lamports. |
err | Empty on success; a non-empty on-chain error description if the transaction failed but was still included in a block. |
logs | Program log lines emitted during execution, in order — useful for debugging a failed or unexpected-result transaction. |
Missing signature: Omitting
signature returns VAL_MISSING_SIGNATURE — 'signature' is required.
sendNative (signing operation)
Builds, signs, submits, and confirms a native SOL transfer from the credentialed wallet to toAddress.
Moves real value: On
mainnet-beta this transfers real SOL. Requires a
credentialID resolving to a CRYPTO_WALLET vault entry — see
Signing & Credentials.
| Field | Type | Required | Description |
|---|---|---|---|
toAddress | text | ✓ Yes | Base58 recipient address. |
lamports | text (integer) | ✓ Yes, > 0 | Amount to send, in lamports. Use utility/convertUnits to convert from SOL first. |
cluster | select | No | See Clusters. Defaults to Solana:DefaultCluster. |
credentialID | vault reference | ✓ Yes | Points at the CRYPTO_WALLET credential holding the payer's secret key. |
Example response:
{
"signature": "3xK9...pQ1",
"status": "confirmed"
}
Validation: Missing
toAddress → VAL_MISSING_TO_ADDRESS. Zero or missing lamports → VAL_MISSING_LAMPORTS — 'lamports' must be greater than zero. Missing/blank credential → a dedicated error asking you to set credentialID.
Why "sendNative" and not a generic instruction call: This node implements the
well-defined, high-value native-transfer write path first. A generic "submit arbitrary caller-built
instructions" operation is intentionally not implemented yet — see Roadmap.