/**
 * @module pda
 * @description Deterministic PDA derivation for every SAP v2 account.
 *
 * Each function returns `[PublicKey, bump]` and is pure — no network
 * calls. All results are memoizable by the caller.
 *
 * Seeds mirror the Rust `#[account(seeds = [...])]` definitions exactly.
 *
 * @category PDA
 * @since v0.1.0
 *
 * @example
 * ```ts
 * import { deriveAgent, deriveEscrow } from "@synapse-sap/sdk/pda";
 *
 * const [agentPda, bump] = deriveAgent(walletPublicKey);
 * const [escrowPda] = deriveEscrow(agentPda, depositor);
 * ```
 */
import { PublicKey } from "@solana/web3.js";
/**
 * Tuple returned by all PDA derivation functions.
 *
 * @name PdaResult
 * @description A readonly tuple of `[pda, bump]` where `pda` is the derived
 *   `PublicKey` and `bump` is the canonical bump seed (`u8`).
 * @category PDA
 * @since v0.1.0
 */
type PdaResult = readonly [pda: PublicKey, bump: number];
/**
 * Derive the **GlobalRegistry** PDA.
 *
 * Seeds: `["sap_global"]`
 *
 * @name deriveGlobalRegistry
 * @description Returns the singleton global registry address used by the SAP program.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see GlobalRegistry account type
 */
export declare const deriveGlobalRegistry: (programId?: PublicKey) => PdaResult;
/**
 * Derive the **AgentAccount** PDA for a given wallet.
 *
 * Seeds: `["sap_agent", wallet]`
 *
 * @name deriveAgent
 * @description Computes the unique agent PDA owned by `wallet`.
 * @param wallet    - The agent owner’s wallet `PublicKey`.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see AgentAccount
 */
export declare const deriveAgent: (wallet: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **AgentStats** PDA for a given agent.
 *
 * Seeds: `["sap_stats", agent_pda]`
 *
 * @name deriveAgentStats
 * @description Computes the stats account PDA associated with an agent.
 * @param agentPda  - The agent’s on-chain PDA.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see AgentStats
 */
export declare const deriveAgentStats: (agentPda: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **AgentPricingMenu** PDA.
 *
 * Seeds: `["sap_pricing", agent_pda]`
 *
 * @name derivePricingMenu
 * @param agentPda  - The agent's PDA.
 * @param programId - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v1.0.0
 */
export declare const derivePricingMenu: (agentPda: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **Feedback** PDA for a reviewer on a specific agent.
 *
 * Seeds: `["sap_feedback", agent_pda, reviewer_wallet]`
 *
 * @name deriveFeedback
 * @description Computes the feedback account PDA scoped to a reviewer–agent pair.
 * @param agentPda  - The target agent’s PDA.
 * @param reviewer  - The reviewer’s wallet `PublicKey`.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see FeedbackAccount
 */
export declare const deriveFeedback: (agentPda: PublicKey, reviewer: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **CapabilityIndex** PDA for a hashed capability string.
 *
 * Seeds: `["sap_cap_idx", capability_hash]`
 *
 * @name deriveCapabilityIndex
 * @description Computes the capability index PDA used to look up agents by capability.
 * @param capabilityHash - SHA-256 hash of the capability string (32 bytes).
 * @param programId      - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see CapabilityIndex
 */
export declare const deriveCapabilityIndex: (capabilityHash: Uint8Array, programId?: PublicKey) => PdaResult;
/**
 * Derive the **ProtocolIndex** PDA for a hashed protocol string.
 *
 * Seeds: `["sap_proto_idx", protocol_hash]`
 *
 * @name deriveProtocolIndex
 * @description Computes the protocol index PDA used to look up agents by protocol.
 * @param protocolHash - SHA-256 hash of the protocol string (32 bytes).
 * @param programId    - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see ProtocolIndex
 */
export declare const deriveProtocolIndex: (protocolHash: Uint8Array, programId?: PublicKey) => PdaResult;
/**
 * Derive the **ToolCategoryIndex** PDA for a tool category discriminant.
 *
 * Seeds: `["sap_tool_cat", category_u8]`
 *
 * @name deriveToolCategoryIndex
 * @description Computes the tool category index PDA used to look up tools by category.
 * @param category  - The `u8` category discriminant (see {@link TOOL_CATEGORY_VALUES}).
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see ToolCategoryIndex
 */
export declare const deriveToolCategoryIndex: (category: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **MemoryVault** PDA for a given agent.
 *
 * Seeds: `["sap_vault", agent_pda]`
 *
 * @name deriveVault
 * @description Computes the memory vault PDA owned by the specified agent.
 * @param agentPda  - The agent’s on-chain PDA.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see MemoryVault
 */
export declare const deriveVault: (agentPda: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **Session** PDA for a vault and session hash.
 *
 * Seeds: `["sap_session", vault_pda, session_hash]`
 *
 * @name deriveSession
 * @description Computes the session PDA scoped to a vault and unique session identifier.
 * @param vaultPda    - The parent vault’s PDA.
 * @param sessionHash - SHA-256 hash identifying the session (32 bytes).
 * @param programId   - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see SessionAccount
 */
export declare const deriveSession: (vaultPda: PublicKey, sessionHash: Uint8Array, programId?: PublicKey) => PdaResult;
/**
 * Derive the **EpochPage** PDA for a session at a given epoch index.
 *
 * Seeds: `["sap_epoch", session_pda, epoch_index_u32_le]`
 *
 * @name deriveEpochPage
 * @description Computes the epoch page PDA for paginated memory inscriptions.
 * @param sessionPda - The parent session’s PDA.
 * @param epochIndex - Zero-based epoch page index.
 * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see EpochPage
 */
export declare const deriveEpochPage: (sessionPda: PublicKey, epochIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **VaultDelegate** PDA for a delegate on a vault.
 *
 * Seeds: `["sap_delegate", vault_pda, delegate_pubkey]`
 *
 * @name deriveVaultDelegate
 * @description Computes the delegate authorization PDA granting a wallet write access to a vault.
 * @param vaultPda  - The parent vault’s PDA.
 * @param delegate  - The delegate’s wallet `PublicKey`.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see VaultDelegate
 */
export declare const deriveVaultDelegate: (vaultPda: PublicKey, delegate: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **Checkpoint** PDA for a session at a given checkpoint index.
 *
 * Seeds: `["sap_checkpoint", session_pda, checkpoint_index_u32_le]`
 *
 * @name deriveCheckpoint
 * @description Computes the checkpoint PDA storing a Merkle snapshot of session state.
 * @param sessionPda      - The parent session’s PDA.
 * @param checkpointIndex - Zero-based checkpoint index.
 * @param programId       - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see Checkpoint
 */
export declare const deriveCheckpoint: (sessionPda: PublicKey, checkpointIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **Tool** PDA for an agent and tool name hash.
 *
 * Seeds: `["sap_tool", agent_pda, tool_name_hash]`
 *
 * @name deriveTool
 * @description Computes the tool registration PDA scoped to an agent and tool identifier.
 * @param agentPda     - The owning agent’s PDA.
 * @param toolNameHash - SHA-256 hash of the tool name (32 bytes).
 * @param programId    - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see ToolAccount
 */
export declare const deriveTool: (agentPda: PublicKey, toolNameHash: Uint8Array, programId?: PublicKey) => PdaResult;
/**
 * Derive the canonical **EscrowV2** PDA for an agent–depositor pair at nonce 0.
 *
 * Seeds: `["sap_escrow_v2", agent_pda, depositor_wallet, 0_u64_le]`
 *
 * @name deriveEscrow
 * @description Computes the canonical V2 escrow PDA holding deposited funds for service payments.
 * @param agentPda  - The service-providing agent’s PDA.
 * @param depositor - The depositor’s wallet `PublicKey`.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @deprecated Since v1.0.0 — This is a V2 nonce-0 compatibility alias. Prefer {@link deriveEscrowV2}.
 * @see EscrowAccountV2
 */
export declare const deriveEscrow: (agentPda: PublicKey, depositor: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **Attestation** PDA for an attester on a specific agent.
 *
 * Seeds: `["sap_attest", agent_pda, attester_wallet]`
 *
 * @name deriveAttestation
 * @description Computes the attestation PDA recording a third-party’s trust assertion.
 * @param agentPda  - The attested agent’s PDA.
 * @param attester  - The attester’s wallet `PublicKey`.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see AttestationAccount
 */
export declare const deriveAttestation: (agentPda: PublicKey, attester: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **MemoryLedger** PDA for a session.
 *
 * Seeds: `["sap_ledger", session_pda]`
 *
 * @name deriveLedger
 * @description Computes the ledger PDA that tracks append-only entries for a session.
 * @param sessionPda - The parent session’s PDA.
 * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see MemoryLedger
 */
export declare const deriveLedger: (sessionPda: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **LedgerPage** PDA for a ledger at a given page index.
 *
 * Seeds: `["sap_page", ledger_pda, page_index_u32_le]`
 *
 * @name deriveLedgerPage
 * @description Computes the ledger page PDA for paginated ledger data storage.
 * @param ledgerPda - The parent ledger’s PDA.
 * @param pageIndex - Zero-based page index.
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.1.0
 * @see LedgerPage
 */
export declare const deriveLedgerPage: (ledgerPda: PublicKey, pageIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **MemoryBuffer** PDA for a session at a given page index.
 *
 * Seeds: `["sap_buffer", session_pda, page_index_u32_le]`
 *
 * @name deriveBuffer
 * @description Computes the buffer page PDA for chunked memory writes within a session.
 * @param sessionPda - The parent session's PDA.
 * @param pageIndex  - Zero-based page index.
 * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.3.1
 * @see MemoryBuffer
 */
export declare const deriveBuffer: (sessionPda: PublicKey, pageIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **SessionDigest** PDA for a session.
 *
 * Seeds: `["sap_digest", session_pda]`
 *
 * @name deriveDigest
 * @description Computes the digest PDA that stores a compact hash summary of a session.
 * @param sessionPda - The parent session's PDA.
 * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.3.1
 * @see SessionDigest
 */
export declare const deriveDigest: (sessionPda: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **PluginConfig** PDA for an agent and plugin type.
 *
 * Seeds: `["sap_plugin", agent_pda, plugin_type_u8]`
 *
 * @name derivePlugin
 * @description Computes the plugin configuration PDA scoped to an agent and plugin type.
 * @param agentPda   - The owning agent's PDA.
 * @param pluginType - The `u8` plugin type discriminant.
 * @param programId  - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.3.1
 * @see PluginConfig
 */
export declare const derivePlugin: (agentPda: PublicKey, pluginType: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **MemoryEntry** PDA for an agent and entry hash.
 *
 * Seeds: `["sap_memory", agent_pda, entry_hash]`
 *
 * @name deriveMemoryEntry
 * @description Computes the memory entry PDA for legacy key-value memory storage.
 * @param agentPda  - The owning agent's PDA.
 * @param entryHash - SHA-256 hash of the entry key (32 bytes).
 * @param programId - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.3.1
 * @see MemoryEntry
 */
export declare const deriveMemoryEntry: (agentPda: PublicKey, entryHash: Uint8Array, programId?: PublicKey) => PdaResult;
/**
 * Derive the **MemoryChunk** PDA for a memory entry at a given chunk index.
 *
 * Seeds: `["sap_mem_chunk", memory_entry_pda, chunk_index_u8]`
 *
 * @name deriveMemoryChunk
 * @description Computes the chunk PDA for fragmented memory entry data.
 * @param memoryEntryPda - The parent memory entry's PDA.
 * @param chunkIndex     - Zero-based chunk index (0–255).
 * @param programId      - Override program ID (defaults to {@link SAP_PROGRAM_ID}).
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.3.1
 * @see MemoryChunk
 */
export declare const deriveMemoryChunk: (memoryEntryPda: PublicKey, chunkIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **EscrowAccountV2** PDA.
 *
 * Seeds: `["sap_escrow_v2", agent_pda, depositor_wallet, nonce_u64_le]`
 *
 * @name deriveEscrowV2
 * @description Computes the V2 escrow PDA supporting nonce-based multi-escrow.
 * @param agentPda  - The agent's PDA.
 * @param depositor - The depositor's wallet.
 * @param nonce     - Escrow nonce (u64) allowing multiple escrows per pair.
 * @param programId - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.5.0
 */
export declare const deriveEscrowV2: (agentPda: PublicKey, depositor: PublicKey, nonce?: number | bigint, programId?: PublicKey) => PdaResult;
/**
 * Derive the **PendingSettlement** PDA.
 *
 * Seeds: `["sap_pending", escrow_v2_pda, settlement_index_u64_le]`
 *
 * @name derivePendingSettlement
 * @param escrowV2Pda     - The parent V2 escrow PDA.
 * @param settlementIndex - The monotonic settlement index (u64).
 * @param programId       - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.5.0
 */
export declare const derivePendingSettlement: (escrowV2Pda: PublicKey, settlementIndex: number | bigint, programId?: PublicKey) => PdaResult;
/**
 * Derive the **DisputeRecord** PDA.
 *
 * Seeds: `["sap_dispute", pending_settlement_pda]`
 *
 * @name deriveDispute
 * @param pendingSettlementPda - The parent pending settlement PDA.
 * @param programId            - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.5.0
 */
export declare const deriveDispute: (pendingSettlementPda: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **AgentStake** PDA.
 *
 * Seeds: `["sap_stake", agent_pda]`
 *
 * @name deriveStake
 * @param agentPda  - The agent's PDA.
 * @param programId - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.5.0
 */
export declare const deriveStake: (agentPda: PublicKey, programId?: PublicKey) => PdaResult;
/**
 * Derive the **Subscription** PDA.
 *
 * Seeds: `["sap_sub", agent_pda, subscriber_wallet, sub_id_u64_le]`
 *
 * @name deriveSubscription
 * @param agentPda   - The agent's PDA.
 * @param subscriber - The subscriber's wallet.
 * @param subId      - Subscription ID (u64).
 * @param programId  - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.5.0
 */
export declare const deriveSubscription: (agentPda: PublicKey, subscriber: PublicKey, subId?: number | bigint, programId?: PublicKey) => PdaResult;
/**
 * Derive the **CounterShard** PDA.
 *
 * Seeds: `["sap_shard", shard_index_u8]`
 *
 * @name deriveShard
 * @param shardIndex - The shard index (0–7).
 * @param programId  - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.5.0
 */
export declare const deriveShard: (shardIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **IndexPage** PDA.
 *
 * Seeds: `["sap_idx_page", parent_index_pda, page_index_u8]`
 *
 * @name deriveIndexPage
 * @param parentIndexPda - The parent index PDA (CapabilityIndex, ProtocolIndex, etc.).
 * @param pageIndex      - The page index (0–255).
 * @param programId      - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.5.0
 */
export declare const deriveIndexPage: (parentIndexPda: PublicKey, pageIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **ReceiptBatch** PDA.
 *
 * Seeds: `["sap_receipt", escrow_v2_pda, batch_index_u32_le]`
 *
 * @name deriveReceiptBatch
 * @description Computes the receipt batch PDA storing a merkle root of call receipts.
 * @param escrowV2Pda - The parent V2 escrow PDA.
 * @param batchIndex  - Zero-based batch index (u32).
 * @param programId   - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.7.0
 */
export declare const deriveReceiptBatch: (escrowV2Pda: PublicKey, batchIndex: number, programId?: PublicKey) => PdaResult;
/**
 * Derive the **SettlementReceipt** PDA (v0.10.0 anti-replay).
 *
 * Seeds: `["sap_recv", escrow_pda, service_hash_or_batch_root]`
 *
 * Created via `init` on every `settle_calls`, `settle_batch`, and
 * `settle_calls_v2`. The PDA's existence after the first call blocks
 * any future replay of the same `service_hash` (or `batch_root`)
 * against the same escrow.
 *
 * @name deriveSettlementReceipt
 * @description Compute the receipt PDA that gates settlement replay.
 * @param escrowPda     - Parent escrow PDA (V1 `EscrowAccount` or V2 `EscrowAccountV2`).
 * @param receiptKey    - 32-byte `service_hash` (single settle / V2 settle)
 *                        or `batch_root = sha256(s_0 || ... || s_{N-1})` (settle_batch).
 * @param programId     - Override program ID.
 * @returns {PdaResult} `[pda, bump]` tuple.
 * @category PDA
 * @since v0.10.0
 */
export declare const deriveSettlementReceipt: (escrowPda: PublicKey, receiptKey: Uint8Array | number[] | Buffer, programId?: PublicKey) => PdaResult;
export {};
//# sourceMappingURL=index.d.ts.map