Overview
A transaction of digital assets refers to the transfer of ownership of digital assets from one party to another. Assets may be transferred between decentralized applications (dApps), individuals or organizations.
After transactions are made, they are verified and recorded as entries on a blockchain network, which is essentially a digital public ledger with no central authority (such as a bank). These entries can be viewed by anyone and cannot be altered.
Digital asset transactions are secured through cryptography. See our Wallets guide for more information on cryptographic keys and how they are used to authenticate transactions.
Transaction Status Flow
When you create a transaction in Palisade, it flows through several stages from initial request to final confirmation on the blockchain. Understanding these stages helps you track transaction progress, handle delays, and troubleshoot issues.
Every transaction follows a predictable path through these stages:
REQUESTED → POLICY CHECK → APPROVAL (optional) → COMPILATION → SIGNATURE → PUBLISHING → CONFIRMATION → CONFIRMED
The Complete Stage Breakdown
| Stage | Description | What Happens |
|---|---|---|
| REQUESTED | Transaction created | Your transaction request is received and queued for processing |
| POLICY_CHECK_PENDING | Policy validation in progress | Palisade verifies the transaction against your configured policies (wallet limits, daily limits, etc.) |
| POLICY_CHECK_PASSED | Policy validation passed | Transaction cleared policy checks and is eligible to proceed |
| APPROVAL_CHECK_PENDING | Awaiting approvals | If your transaction requires approvals, it waits here for authorized users to approve it |
| APPROVAL_CHECK_PASSED | All approvals obtained | Required approvals have been granted |
| COMPILATION_PENDING | Preparing for blockchain | Transaction is being prepared and encoded for the target blockchain |
| COMPILED | Blockchain-ready | Transaction is now in blockchain format and ready for signing |
| SIGNATURE_PENDING | Waiting for signature | Transaction is waiting to be cryptographically signed by your wallet |
| SIGNED | Signature complete | Transaction has been signed and is ready to submit to the blockchain |
| PUBLISH_PENDING | Submitting to blockchain | Transaction is being submitted to the blockchain network |
| PUBLISHED | On the blockchain | Transaction has been received by the blockchain network |
| CONFIRMATION_PENDING | Waiting for finality | Blockchain is processing the transaction; awaiting block confirmation |
| CONFIRMED | Transaction complete | Transaction is finalized on the blockchain (terminal state) |
Important Notes
Linear Progression: Transactions always move forward through these stages—they never go backward. Once a stage is passed, the transaction continues forward.
Approvals Are Optional: If your wallet doesn't require approvals, the transaction skips the APPROVAL_CHECK_PENDING and APPROVAL_CHECK_PASSED stages entirely.
Asynchronous Processing: Status updates happen automatically as Palisade and the blockchain process your transaction. You don't need to take action between stages.
Failure States: At any stage, a transaction may be rejected or fail:
- REJECTED: The transaction was denied (e.g., policy rejection, approval denial)
- FAILED: A technical error occurred during processing
Monitoring Transaction Status
You can check transaction status through:
- Dashboard: View status in the Transactions tab of your wallet
- API: Use the transactions API to programmatically fetch current status
- Webhooks: Get real-time notifications when transactions change status (see Webhooks)
Updated 4 days ago
