Skip to content

Meta Merkles

The MetaMerklesSDK manages Meta Merkles — an on-chain merkle tree metadata storage contract that other contracts can ingest. Its primary use is decentralizing royalties across the marketplace, auction, and raffle systems.

Instead of storing metadata for every individual asset on-chain (expensive), Meta Merkles:

  1. Groups asset metadata (including royalty splits) into a merkle tree
  2. Stores only the merkle root on-chain
  3. Allows anyone to verify an asset’s metadata by providing a merkle proof

Marketplace, auction, and raffle contracts verify royalty information on-chain through MetaMerkles proofs, ensuring creators receive their royalties without relying on off-chain metadata.

import { MetaMerklesSDK } from '@akta/sdk/meta-merkles'
const metaMerkles = new MetaMerklesSDK({ algorand })

The SDK includes a tree builder utility for constructing merkle trees:

import { MerkleTree } from '@akta/sdk/meta-merkles'
  • Efficient storage — Only merkle roots stored on-chain
  • Verifiable — Anyone can verify metadata with a proof
  • Batch updates — Update metadata for entire groups at once
  • SDK tree builder — Built-in utility for constructing trees