Class PDAManager

PDAManager - manages Program Derived Addresses for Merkle storage

This class provides utilities to derive and manage PDAs used for storing large amounts of transaction data on-chain using a Merkle tree approach. Compatible with OOBE Protocol patterns but using pure Solana libraries.

Index

Constructors

constructor

Methods

checkPDAExistence getAllUserPDAs getBatchConfig getBatchPDAAccountInfo getPDAAccountInfo getUserPDAs getUserPersonalityPDAs updateBatchConfig validatePDA

Constructors

constructor

new PDAManager(client, walletAddress, config?, programId?, batchConfig?): PDAManager
Create a new PDAManager instance
Parameters
- client: SynapseClient
  Synapse client for RPC calls
- walletAddress: string
  User wallet address
- Optionalconfig: PDAConfig
  Optional PDA configuration
- OptionalprogramId: string
  Optional program ID (defaults to System Program)
- OptionalbatchConfig: BatchOptionRequest
  Optional batch processing configuration
Returns PDAManager
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:78

Methods

checkPDAExistence

checkPDAExistence(pdas): Promise<{
leafExists: boolean;
rootExists: boolean;
}>
Check if PDA accounts exist on-chain Uses Synapse client's batch() for optimal performance
Parameters
- pdas: UserPDAs
  UserPDAs to check
Returns Promise<{
leafExists: boolean;
rootExists: boolean;
}>
Object indicating which PDAs exist
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:180

getAllUserPDAs

getAllUserPDAs(): {
personality: UserPDAs;
standard: UserPDAs;
}
Get all PDAs for a wallet (convenience method) Returns both standard and personality PDAs

Returns {
personality: UserPDAs;
standard: UserPDAs;
}
- personality: UserPDAs
- standard: UserPDAs
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:262

getBatchConfig

getBatchConfig(): BatchOptionRequest
Get batch configuration

Returns BatchOptionRequest
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:272

getBatchPDAAccountInfo

getBatchPDAAccountInfo(pdas): Promise<any[]>
Get multiple PDA account infos using batch for optimal performance
Parameters
- pdas: PublicKey[]
  Array of PDA public keys
Returns Promise<any[]>
Array of account infos (null if not found)
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:226

getPDAAccountInfo

getPDAAccountInfo(pda): Promise<null | AccountInfo>
Get PDA account info using Synapse client
Parameters
- pda: PublicKey
  PDA public key
Returns Promise<null | AccountInfo>
Account info or null
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:210

getUserPDAs

getUserPDAs(customConfig?): UserPDAs
Get user PDAs for Merkle data storage Derives two PDAs: one for storing leaf/chunk data, one for roots
Parameters
- OptionalcustomConfig: PDAConfig
  Optional custom seed configuration
Returns UserPDAs
UserPDAs with leaf and root addresses + bumps
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:119

getUserPersonalityPDAs

getUserPersonalityPDAs(): UserPDAs
Get user PDAs for Personality storage (OOBE Agent personality system) Similar to getUserPDAs but uses personality-specific seeds

Returns UserPDAs
UserPDAs for personality data
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:149

updateBatchConfig

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

validatePDA

validatePDA(pda, seeds): boolean
Validate PDA derivation (utility for debugging)
Parameters
- pda: PublicKey
  PDA to validate
- seeds: Buffer<ArrayBufferLike>[]
  Seeds used for derivation
Returns boolean
true if PDA matches expected derivation
- Defined in packages/synapse-client-sdk/src/ai/pda-manager.ts:249

Class PDAManager

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns PDAManager

Methods

checkPDAExistence

Parameters

Returns Promise<{
leafExists: boolean;
rootExists: boolean;
}>

getAllUserPDAs

Returns {
personality: UserPDAs;
standard: UserPDAs;
}

personality: UserPDAs

standard: UserPDAs

getBatchConfig

Returns BatchOptionRequest

getBatchPDAAccountInfo

Parameters

Returns Promise<any[]>

getPDAAccountInfo

Parameters

Returns Promise<null | AccountInfo>

getUserPDAs

Parameters

Returns UserPDAs

getUserPersonalityPDAs

Returns UserPDAs

updateBatchConfig

Parameters

Returns void

validatePDA

Parameters

Returns boolean

Settings

On This Page

Class PDAManager

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns PDAManager

Methods

checkPDAExistence

Parameters

Returns Promise<{ leafExists: boolean; rootExists: boolean; }>

getAllUserPDAs

Returns { personality: UserPDAs; standard: UserPDAs; }

personality: UserPDAs

standard: UserPDAs

getBatchConfig

Returns BatchOptionRequest

getBatchPDAAccountInfo

Parameters

Returns Promise<any[]>

getPDAAccountInfo

Parameters

Returns Promise<null | AccountInfo>

getUserPDAs

Parameters

Returns UserPDAs

getUserPersonalityPDAs

Returns UserPDAs

updateBatchConfig

Parameters

Returns void

validatePDA

Parameters

Returns boolean

Settings

On This Page

Returns Promise<{
leafExists: boolean;
rootExists: boolean;
}>

Returns {
personality: UserPDAs;
standard: UserPDAs;
}