Class MerkleOperation

MerkleOperation - handles Merkle tree operations and on-chain storage

This class provides utilities for:

Generating Merkle trees from event data
Creating and verifying proofs
Splitting large data into chunks
Inscribing data on-chain via memo transactions

For on-chain operations, you can provide either:

A Solana Connection + Signer for real transaction signing
Just use SynapseClient (will require pre-signed transactions)

Index

Constructors

constructor

Methods

batchInscribeOnChain batchVerifyProofs calculateChunks createMerkleTree createUnsignedMemoTransaction createZeroChunk getBatchConfig getLeaves getMerkleProof getPDAManager getRoot inscribeOnChain setSigner updateBatchConfig verifyProof

Constructors

constructor

new MerkleOperation(client, walletAddress, batchConfig?, connection?, signer?): MerkleOperation
Create a new MerkleOperation instance
Parameters
- client: SynapseClient
  Synapse client for RPC calls
- walletAddress: string
  User wallet address
- OptionalbatchConfig: BatchOptionRequest
  Optional batch processing configuration
- Optionalconnection: Connection
- Optionalsigner: Signer | Keypair
  Optional Signer/Keypair for signing transactions
Returns MerkleOperation
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:131

Methods

batchInscribeOnChain

batchInscribeOnChain(validationResults, pdas?): Promise<InscriptionResult[]>
Batch inscribe multiple validation results on-chain Uses client.batch() for optimal performance when inscribing multiple proofs
Parameters
- validationResults: MerkleValidationResult[]
  Array of merkle validation results
- Optionalpdas: UserPDAs
  Optional custom PDAs
Returns Promise<InscriptionResult[]>
Array of inscription results
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:662

batchVerifyProofs

batchVerifyProofs(proofs): boolean[]
Batch verify multiple Merkle proofs
Parameters
- proofs: {
      leaf: string;
      proof: string[];
      root: string;
  }[]
  Array of proof objects to verify
Returns boolean[]
Array of verification results
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:244

calculateChunks

calculateChunks(buffer, minChunkSize?, maxChunkSize?): Buffer<ArrayBufferLike>[]
Parameters
- buffer: Buffer<ArrayBufferLike>
- minChunkSize: number = 1
- maxChunkSize: number = 560
Returns Buffer<ArrayBufferLike>[]
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:256

createMerkleTree

createMerkleTree(data): string
Create Merkle tree from data array
Parameters
- data: string[]
  Array of data items to hash
Returns string
Merkle root hash (hex)
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:157

createUnsignedMemoTransaction

createUnsignedMemoTransaction(pda, data): Promise<Transaction>
Get unsigned transaction for external signing Useful for wallet adapter integration
Parameters
- pda: PublicKey
  Target PDA
- data: Buffer<ArrayBufferLike>
  Data buffer to store in memo
Returns Promise<Transaction>
Unsigned Transaction object
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:627

createZeroChunk

createZeroChunk(leaf): Buffer<ArrayBufferLike>
Create zero chunk (128 bytes: 2 merkle leaves + previous signature)
Parameters
- leaf: MerkleLeaf
  Merkle leaf data
Returns Buffer<ArrayBufferLike>
Zero chunk buffer (128 bytes)
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:290

getBatchConfig

getBatchConfig(): BatchOptionRequest
Get batch configuration

Returns BatchOptionRequest
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:599

getLeaves

getLeaves(): string[]
Get all leaves

Returns string[]
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:585

getMerkleProof

getMerkleProof(leafData): MerkleProof
Get Merkle proof for a leaf
Parameters
- leafData: string
  Data to generate proof for
Returns MerkleProof
Merkle proof
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:187

getPDAManager

getPDAManager(): PDAManager
Get PDA manager

Returns PDAManager
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:592

getRoot

getRoot(): string
Get current Merkle root

Returns string
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:578

inscribeOnChain

inscribeOnChain(validationResult, pdas?): Promise<InscriptionResult>
On-chain Merkle inscription - stores data + proof on Solana Uses PDA accounts to store chunked data and merkle roots
Parameters
- validationResult: MerkleValidationResult
  Merkle validation result to inscribe
- Optionalpdas: UserPDAs
  Optional custom PDAs
Returns Promise<InscriptionResult>
Inscription result with signatures and PDAs
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:309

setSigner

setSigner(signer): void
Set signer for transaction signing
Parameters
- signer: Signer | Keypair
  Keypair or Signer instance
Returns void
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:615

updateBatchConfig

updateBatchConfig(config): void
Update batch configuration
Parameters
- config: Partial<BatchOptionRequest>
Returns void
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:606

verifyProof

verifyProof(leaf, proof, root): boolean
Verify a Merkle proof
Parameters
- leaf: string
  Leaf hash
- proof: string[]
  Proof hashes
- root: string
  Expected root hash
Returns boolean
true if proof is valid
- Defined in packages/synapse-client-sdk/src/ai/merkle-operation.ts:224

Class MerkleOperation

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns MerkleOperation

Methods

batchInscribeOnChain

Parameters

Returns Promise<InscriptionResult[]>

batchVerifyProofs

Parameters

Returns boolean[]

calculateChunks

Parameters

Returns Buffer<ArrayBufferLike>[]

createMerkleTree

Parameters

Returns string

createUnsignedMemoTransaction

Parameters

Returns Promise<Transaction>

createZeroChunk

Parameters

Returns Buffer<ArrayBufferLike>

getBatchConfig

Returns BatchOptionRequest

getLeaves

Returns string[]

getMerkleProof

Parameters

Returns MerkleProof

getPDAManager

Returns PDAManager

getRoot

Returns string

inscribeOnChain

Parameters

Returns Promise<InscriptionResult>

setSigner

Parameters

Returns void

updateBatchConfig

Parameters

Returns void

verifyProof

Parameters

Returns boolean

Settings

On This Page