OmniProtocol Transactions and Smart Properties

The Omni Protocol is a powerful layer built on top of the Bitcoin blockchain, enabling the creation and management of digital assets, smart properties, and decentralized token exchanges. It supports advanced features such as user-issued tokens, crowdsales, atomic trades, and fine-grained control over token behavior — all secured by Bitcoin’s immutable ledger.

Whether you're a developer building decentralized applications or a project issuer launching a new token, understanding how to interact with the Omni Protocol via its RPC interface is essential. This guide provides a comprehensive overview of key transaction types, data retrieval methods, raw transaction tools, and fee mechanisms — all optimized for clarity, usability, and search visibility.

Transaction Creation

Creating transactions on the Omni Protocol allows users to transfer tokens, manage supply, trade assets, and more. Each operation returns a transaction hash upon successful broadcast.

omni_send

Send tokens from one address to another.

Parameters:

• fromaddress (string) – The sender's address
• toaddress (string) – The recipient's address
• propertyid (string) – The token identifier
• amount (string) – The amount to send

Example:

omnicore-cli "omni_send" "3M9qvHKtgARhqcMtM5cRT9VaiDJ5PSfQGY" "37FaKponF7zqoMLUjEiko25pDiuVH5YLEa" 1 "100.0"

Result:

"hash"

👉 Discover how to securely manage digital assets using blockchain protocols

omni_senddexsell

Place, update, or cancel a sell offer on the distributed OMNI/BTC exchange.

Parameters:

• fromaddress – Sender address
• propertyidforsale – Token ID for sale (1 = OMNI, 2 = TOMNI)
• amountforsale – Quantity of tokens to sell
• amountdesired – Desired BTC amount
• paymentwindow – Time limit (in blocks) for buyer to pay
• minacceptfee – Minimum mining fee buyer must pay
• action – 1: new offer, 2: update, 3: cancel

Example:

omnicore-cli "omni_senddexsell" "37FaKponF7zqoMLUjEiko25pDiuVH5YLEa" 1 "1.5" "0.75" 25 "0.0005" 1

omni_sendissuancecrowdsale

Launch a new token through a crowdsale.

Parameters include:

• ecosystem – 1 (main), 2 (test)
• type – 1 (indivisible), 2 (divisible)
• name, url, data – Metadata
• tokensperunit, deadline, earlybonus, issuerpercentage

This method empowers startups and projects to raise funds in a decentralized manner while distributing utility or equity tokens.

omni_sendissuancefixed

Create a token with a fixed supply.

Unlike crowdsales, this method mints the full token supply immediately. Ideal for stablecoins, reward points, or NFT-like assets.

Key parameter: amount – total tokens created.

omni_sendgrant & omni_sendrevoke

Issue (grant) or destroy (revoke) units of managed tokens. These are useful for dynamic token economies where supply adjusts based on user activity or governance decisions.

omni_sendtrade & omni_sendcanceltrades*

Enable peer-to-peer trading directly on-chain:

• omni_sendtrade: Place an order
• canceltradesbyprice: Cancel specific price-level offers
• canceltradesbypair: Cancel all offers for a trading pair
• cancelalltrades: Cancel all active offers in an ecosystem

These functions support trustless, transparent trading without relying on centralized exchanges.

omni_sendfreeze / unfreeze

Freeze tokens in specific addresses — crucial for compliance, dispute resolution, or anti-fraud measures. Only the issuer can freeze/unfreeze balances, and freezing applies only to managed properties with freezing enabled.

Data Retrieval

Access real-time insights into the Omni ecosystem using robust querying tools.

omni_getbalance & omni_getallbalancesforaddress

Check token balances for any address. Supports filtering by property ID or retrieving all holdings.

Returns:

• Available balance
• Reserved amount (for pending trades)
• Frozen balance (if applicable)

omni_listproperties & omni_getproperty

List all issued tokens or retrieve detailed information about a specific asset:

• Name, category, divisibility
• Issuer address
• Total supply
• Creation transaction

Useful for explorers, wallets, and analytics platforms.

omni_getactivedexsells & omni_getorderbook

Monitor active sell orders and market depth across the decentralized exchange. Gain visibility into liquidity, pricing trends, and trading volume.

omni_gettransaction & omni_listtransactions

Retrieve details of individual transactions or list wallet history:

• Transaction type
• Confirmation status
• Fees
• Timestamp

Essential for auditing and integration with blockchain analytics tools.

omni_getcrowdsale & omni_getactivecrowdsales

Track ongoing and past crowdfunding campaigns:

• Participation levels
• Bonus distribution
• Deadline tracking

Developers can use this data to verify campaign success or integrate real-time dashboards.

Raw Transaction Tools

For advanced use cases requiring custom transaction construction.

omni_createrawtx_* & omni_decodetransaction

Build and decode raw Omni transactions step-by-step:

• Add inputs, outputs, OP_RETURN payloads
• Embed metadata securely
• Decode hex-encoded transactions for verification

These tools are ideal for building custom wallets, smart contracts, or integration middleware.

omni_createpayload_*

Generate protocol-compliant payloads without broadcasting:

• simplesend
• issuancefixed
• dexsell
• trade

You can combine these with Bitcoin’s signrawtransaction and sendrawtransaction for full control over transaction lifecycle.

Fee System

The Omni Protocol includes a built-in fee distribution mechanism that rewards stakeholders.

omni_getfeeshare & omni_getfeedistributions

View:

• Current fee share percentages per address
• Historical fee distributions
• Cached fees awaiting disbursement

Projects can incentivize long-term holding by configuring fee-sharing models where token holders earn passive income from network activity.

Frequently Asked Questions (FAQ)

Q: What is the difference between fixed and managed tokens?
A: Fixed supply tokens have a predetermined total amount created at issuance. Managed tokens allow the issuer to mint or revoke units over time using omni_sendgrant and omni_sendrevoke.

Q: Can I trade OMNI tokens directly on the protocol?
A: Yes. The Omni Protocol includes a decentralized exchange (DEX) where users can place buy/sell orders for any supported token pair using BTC or other Omni tokens.

Q: How are fees distributed in the Omni network?
A: Transaction fees are pooled and periodically distributed to eligible addresses based on their token holdings and configured sharing rules via omni_getfeeshare.

Q: Is it safe to use omni_sendrawtx?
A: Yes, but only if you fully understand the payload structure. Always test on the testnet first and validate inputs before broadcasting.

Q: Can I freeze someone else's tokens?
A: No. Only the issuer of a managed property with freezing enabled can freeze balances — and only in that specific token.

👉 Learn how blockchain-powered asset management is shaping the future of finance

Core Keywords

• Omni Protocol
• Smart Properties
• Token Issuance
• Decentralized Exchange (DEX)
• Blockchain Transactions
• Managed Tokens
• Crowdsale Launch
• Fee Distribution

By mastering these RPC commands and concepts, developers and organizations can unlock powerful decentralized capabilities — from launching custom tokens to enabling transparent, trustless trading ecosystems.