Chialisp Guide Pt 6: Chia Offers 101 Build, Sign, Post

8 min read

build sign post workflow diagram showing three phases of peer-to-peer blockchain trading to illustrate how to create chia offers peer to peer trading

Key Takeaways:

  • Chia offers allow peer-to-peer trading without centralized exchanges or middlemen
  • Building an offer creates an incomplete spend bundle that locks your coins and specifies requested assets
  • Signing uses BLS signatures to secure both maker and taker transactions cryptographically
  • Posting broadcasts the completed spend bundle to the Chia network for on-chain confirmation
  • Offer files are tamper-proof, portable, and can be shared anywhere from social media to decentralized exchanges

Article Summary: Chialisp offers enable trustless peer-to-peer asset swaps on the Chia blockchain through three steps: build (create offer file with locked coins), sign (complete with BLS signatures from both parties), and post (broadcast to network). This system eliminates exchange fees, counterparty risk, and the need for custodians while keeping users in full control of their private keys.

What Are Chialisp Offers?

Chia offers represent a powerful primitive for decentralized trading built directly into the Chia blockchain. An offer is a partially complete spend bundle that locks some of your coins and specifies what assets you want in return. Think of it like writing a check that can only be cashed when someone gives you exactly what you asked for in exchange.

Unlike traditional cryptocurrency exchanges where you deposit funds into an account controlled by someone else, Chia offers let you keep control of your private keys the entire time. You create a special file that describes your trade, share it however you want, and anyone who agrees to your terms can complete the transaction. The beauty is that nobody can change your terms or steal your funds because the offer file is cryptographically secured.

Offers work with all standard Chia assets including XCH (the native coin), CATs (Chia Asset Tokens like stablecoins), and NFTs. You can offer one asset for another, multiple assets for multiple assets, or even create complex multi-party trades that get settled atomically. The settlement payments puzzle handles all the coordination to make sure everyone gets exactly what they agreed to, or nobody gets anything.

Gene Hoffman, Chia’s President and COO, explains the significance: “In an evolving DeFi ecosystem, Chia is meeting critical security and compliance needs to make peer-to-peer transactions safer and easier.”

The Three Phases of Chialisp Offers

Creating and completing a Chia offer follows three distinct phases that work together to enable trustless peer-to-peer trading. Each phase plays a critical role in maintaining security while keeping the process simple for users.

Phase 1: Build Your Offer

Building an offer means constructing an offer file that encodes your trade proposal. When you use either the Chia wallet GUI or command line interface, the software selects coins from your wallet to lock and creates an incomplete spend bundle targeting the settlement payments puzzle. This spend bundle announces what assets you are offering and what assets you want to receive in return.

The CLI command follows this pattern: chia wallet make_offer -o <wallet_id:amount> -r <wallet_id:amount> -p <path>. For example, offering 1000 CAT for 0.01 XCH would look like: chia wallet make_offer -o 2:1000 -r 1:0.01 -p ~/offers/my_trade.offer. The -o flag specifies what you offer, the -r flag specifies what you request, and -p sets where to save the file.

The offer file itself is just a few kilobytes of data that you can share anywhere. Post it on Reddit, Twitter, Discord, send it in an email, or upload it to decentralized exchanges like Dexie. You can also broadcast offers through the Splash network, a decentralized peer-to-peer protocol that distributes offers across the Chia ecosystem without any centralized intermediary. The file does not contain your private keys or any way to deduce them, so sharing it publicly is completely safe. If someone tries to modify the file to change the terms, it becomes invalid and cannot be executed on the blockchain.

Phase 2: Sign the Transaction

Signing is where cryptographic security enters the picture through BLS (Boneh-Lynn-Shacham) signatures. When you build the offer, your wallet already signs your side of the transaction using your private keys. However, the offer remains intentionally incomplete because it still needs coins and signatures from the person accepting your offer.

BLS signatures have a special property called non-interactive aggregation, meaning multiple signatures can be combined into a single signature that verifies all the messages together. When someone accepts your offer, their wallet creates a new spend bundle that merges your locked inputs with their own inputs, adds the required puzzle announcements, and signs their portion with their private keys. The result is a complete spend bundle with an aggregated signature covering both parties.

The signing process ensures that both the maker (person who created the offer) and the taker (person who accepts it) must cryptographically prove they control the coins they are spending. Neither party can spend the other’s coins, change the trade terms, or steal funds because any alteration breaks the cryptographic signatures and makes the entire transaction invalid.

Phase 3: Post and Execute

Posting means broadcasting the completed spend bundle to the Chia network so it can be included in a block. After the taker’s wallet completes the offer by adding their coins and signatures, it submits this combined spend bundle to a full node through the wallet RPC interface. The spend bundle enters the mempool where it waits to be picked up by a farmer.

Once a farmer includes the spend bundle in a block and that block gets confirmed on the blockchain, the offer status changes to confirmed and the atomic swap completes. Both parties receive their assets simultaneously, or if something goes wrong and the transaction cannot complete, nobody receives anything. This atomic property means there is zero counterparty risk—you never have a situation where one person gets paid but the other does not.

The entire process happens peer-to-peer without any centralized authority, smart contract vulnerability, or exchange fee. Makers and takers interact directly through offer files, and the blockchain simply validates and records the final transaction when both parties agree on terms.

Comparing Chia Offers to Traditional Methods

FeatureChia OffersCentralized ExchangesEthereum DEXs
CustodySelf-custody maintainedExchange holds fundsSelf-custody maintained
Trading FeesBlockchain transaction fee only (~$0.01)0.1-1% per tradeGas fees + protocol fees
Counterparty RiskZero (atomic settlement)Exchange solvency riskSmart contract risk
Share MethodAny channel (email, social, file)Platform-lockedPlatform-locked
KYC RequiredNoYesNo
ExecutionAtomic on-chain settlementOff-chain order matchingSmart contract execution

How to Create Offers Using the Command Line

The Chia command line interface provides the most direct way to create and manage offers. Before you start, make sure you have the Chia blockchain installed and synced, with a wallet containing the assets you want to trade. You also need to know your wallet IDs for each asset type—run chia wallet show to see your wallet list.

Creating a basic offer follows these steps. First, decide what you want to offer and what you want in return. Let’s say you have 10 USDS (a Chia stablecoin) in wallet ID 2 and you want to trade it for 0.1 XCH from wallet ID 1. Your command would be:

chia wallet make_offer -o 2:10 -r 1:0.1 -p ~/offers/my_first_offer.offer

The wallet will show you a summary of the trade and ask for confirmation. Type ‘y’ to proceed, and it creates the offer file at the path you specified. You can then share this file with potential takers through any channel you prefer.

For more complex offers involving multiple assets, simply add more -o and -r flags. Trading 10 USDS and 1000 CKC for 0.1 XCH and 500 SBX would look like: chia wallet make_offer -o 2:10 -o 3:1000 -r 1:0.1 -r 4:500 -p ~/offers/multi_asset.offer. The wallet automatically handles all the coordination to make sure the trade settles atomically.

To accept someone else’s offer, use the take_offer command: chia wallet take_offer ~/downloads/their_offer.offer. This shows you exactly what they are offering and requesting. If you agree to the terms, confirm with ‘y’ and your wallet completes the spend bundle, signs it, and broadcasts it to the network. Within minutes, once the transaction confirms in a block, both you and the maker receive your respective assets.

Security Best Practices for Chialisp Offers

While Chia offers provide strong security guarantees through cryptography and atomic settlement, users still need to follow best practices to protect themselves. The most important rule is to always verify what you are receiving before accepting an offer. Malicious actors sometimes create fake CATs with names similar to popular tokens, then offer them in hopes that someone accepts without checking the asset ID.

Before accepting any offer for a CAT you do not recognize, look up the asset ID and confirm it matches the legitimate token. The Chia community maintains lists of known CAT asset IDs, and reputable platforms like Dexie display verified token information. Never accept an offer just because the token name looks right—always verify the underlying asset ID hash.

Setting reasonable expiration times for your offers prevents unwanted arbitrage situations months after you have forgotten about the trade. When creating an offer, you can specify a block height or timestamp after which the offer becomes invalid. This is especially important for price-sensitive trades where market conditions change rapidly. Most wallets default to seven-day expiration, but you can adjust this based on how quickly you expect the offer to be taken.

Keep your wallet software updated to the latest version to benefit from security patches and improvements. The Chia development team continuously enhances the offer system based on community feedback and discovered edge cases. Also be cautious about where you share your offer files—while they do not contain private keys, sharing them in scam-prone venues increases the risk that less informed users might accept bad trades.

Cross-Chain Trading with Bridged Assets

As of January 2026, Chia offers support trading with assets bridged from other blockchains through cross-chain protocols. Cross-chain bridges like Warp.Green enable wrapped assets from Ethereum and Base to be used in Chia offers. This includes wUSDC.b (wrapped USDC from Base), wETH, and wBTC, expanding trading options while maintaining the security benefits of Chia’s offer system.

When trading bridged assets, the same offer mechanics apply—you build an offer specifying the bridged CAT you want to trade, sign it with your private key, and post it for others to accept. The atomic settlement guarantees extend to bridged assets just as they do for native Chia tokens, eliminating counterparty risk even when trading cross-chain wrapped assets.

Real-World Use Cases

Case Study 1: Dexie, the leading Chia offer aggregator, enables users to trade CATs and NFTs through native peer-to-peer offers without custodial risk or protocol fees. By monitoring the Splash network and indexing available offers, Dexie demonstrates how decentralized liquidity can be shared across the entire Chia ecosystem without any single platform controlling the order book.

Case Study 2: Since August 2024, EcoRegistry has enabled transparent carbon credit trading on Chia through native offers. Tokenized carbon credits from verified projects are listed on Dexie, where buyers can purchase and retire credits using XCH or wUSDC.b from the Warp.Green bridge, with transactions recorded in the World Bank’s Climate Action Data Trust. To learn how to bridge assets like wUSDC.b from Ethereum or Base to Chia, see our comprehensive guide on bridging to Chia with Warp.Green, Offers, and CAT Gateways.

Conclusion

Chialisp offers represent a fundamental advancement in decentralized trading by eliminating the need for intermediaries, custodians, and vulnerable smart contracts. The three-phase process of building, signing, and posting creates a trustless system where users maintain complete control of their private keys and assets throughout the entire transaction. By combining BLS signature aggregation, atomic settlement guarantees, and tamper-proof offer files, Chia delivers peer-to-peer trading that is simpler, safer, and more cost-effective than traditional alternatives. Whether you are swapping stablecoins, trading NFTs, or exchanging CATs, mastering the build-sign-post workflow empowers you to participate in decentralized finance without compromising security or paying unnecessary fees. Start experimenting with small test trades to build confidence, always verify asset IDs before accepting offers, and take advantage of the vibrant ecosystem of offer aggregators like Dexie and the Splash network to discover trading opportunities.

Chialisp Offers 101: Build, Sign, Post FAQs

What is the difference between building and signing a Chialisp offer?

Building creates the offer file with locked coins and trade terms, while signing adds cryptographic BLS signatures from your private keys. The build phase happens when you run the make_offer command, and signing occurs automatically as part of that process for the maker, then again when the taker accepts the offer.

Can I cancel a Chialisp offer after posting it?

Yes, you can cancel an offer by spending the coins it references using the chia wallet cancel_offer command. Once those coins are spent in another transaction, the offer becomes invalid because it can no longer reference the original coins it was built with.

How does Chialisp Offers 101: Build, Sign, Post ensure security?

The build-sign-post process ensures security through cryptographic signatures, atomic settlement, and tamper-proof offer files. BLS signatures verify ownership of coins, atomic settlement guarantees both parties get paid or neither does, and any modification to the offer file invalidates the cryptographic proofs.

Where can I share my Chialisp offer files?

You can share offer files anywhere including social media (Twitter, Reddit, Discord), direct messaging apps, email, or upload them to decentralized exchanges like Dexie. You can also broadcast them through the Splash network for peer-to-peer distribution. Offer files contain no private keys, making them safe to share publicly.

What happens if someone modifies my Chialisp Offers 101: Build, Sign, Post file?

Any modification to the offer file breaks the cryptographic signatures and makes it invalid. The Chia blockchain will reject the tampered offer because the signatures no longer match the content, ensuring nobody can change your trade terms without your permission.

Chialisp Offers 101: Build, Sign, Post Citations

  1. Chialisp.com – Offers: https://chialisp.com/offers/
  2. Chia Documentation – Offers CLI Tutorial: https://docs.chia.net/guides/offers-cli-tutorial/
  3. Chia Network – Unlocking Global Peer-to-Peer Markets: https://www.chia.net/2024/02/16/chia-offers-unlocking-global-peer-to-peer-markets/
  4. Business Wire – Chia Launches Native P2P Exchange: https://www.businesswire.com/news/home/20220112005414/en/Chia-Launches-the-First-Native-Peer-to-Peer-Exchange-Capabilities-and-DEXs
  5. Chialisp.com – BLS Signatures: https://chialisp.com/chialisp-bls-signatures/
  6. Chia Documentation – Offer CLI Reference: https://docs.chia.net/offer-cli/
  7. Dexie – Chia Offer Aggregator: https://dexie.space/markets
  8. Chia Documentation – Wallet Guide: https://chialisp.com/docs/tutorials/offers_gui_tutorial/
  9. Chialisp.com – About Chialisp: https://chialisp.com
  10. Chialisp.com – Chialisp Primer: https://chialisp.com/chialisp-primer/
  11. Chia Documentation – Wallet CLI: https://docs.chia.net/wallet-cli/
  12. Chia Documentation – CATs, Offers and NFTs: https://docs.chia.net/guides/crash-course/cats-offers-nfts/
  13. Chia Network – Introducing Chialisp: https://chia.net/2019/11/27/chialisp.en.html
  14. ChiaLinks – Exchanges: https://chialinks.com/exchanges/
  15. Chia Documentation – DAO CLI Guide: https://docs.chia.net/dao-cli-guide/
  16. Chia Documentation – Chialisp and TypeScript: https://docs.chia.net/guides/crash-course/chialisp-and-typescript/
  17. Chia Documentation – Wallet Guide CAT Security: https://docs.chia.net/reference-client/getting-started/wallet-guide/
  18. CoinDesk – Chia Network Launches P2P Trading: https://www.coindesk.com/business/2022/01/12/chia-network-launches-native-peer-to-peer-trading-services-for-wallet-holders
  19. Dexie Notes – Decentralized Liquidity with Chia Offers: https://notes.dexie.space/p/decentralized-liquidity-with-chia
  20. Chia Network – Carbon Credits Available via Offers: https://www.chia.net/2024/08/28/carbon-credits-are-now-available-for-purchase-with-offers/
  21. Splash Network – Decentralized Offer Distribution: https://github.com/dexie-space/splash
  22. Warp.Green – Cross-Chain Bridge: https://warp.green
  23. Chia Network – Why Chia Chose BLS Signatures: https://www.chia.net/2025/11/25/crypto-signatures-and-why-chia-chose-bls/
  24. Chia Documentation – Offers Academy: https://docs.chia.net/academy-offers/