@heyanon-arp/sdk 0.0.29 → 0.0.31

package/dist/escrow/index.d.ts

@@ -5,3 +5,4 @@ export type { EscrowConfigStatus } from './config-status';
 export { buildCreateLockIxData, computeCreateLockDiscriminator, CREATE_LOCK_DISCRIMINATOR, CREATE_LOCK_NATIVE_DISCRIMINATOR, type CreateLockArgs, } from './create-lock';
 export { ESCROW_PDA_SEEDS, NO_ARG_LIFECYCLE_INSTRUCTIONS, type NoArgLifecycleInstruction, instructionDiscriminator, buildLifecycleIxData, buildResolveDisputeIxData, type ResolveDisputeArgs, } from './lifecycle-instructions';
 export { LOCK_ACCOUNT_SIZE, LOCK_ACCOUNT_DISCRIMINATOR, LOCK_STATE_NAMES, LOCK_TERMINAL_STATES, LockStates, LockTerminalStates, ESCROW_RELEASE_METHODS, EscrowReleaseMethods, NATIVE_SOL_MINT_BASE58, type LockStateName, type LockTerminalState, type EscrowReleaseMethodName, isEscrowReleaseMethod, type DecodedLockAccount, decodeLockAccount, computeLockAccountDiscriminator, } from './lock-account';
+export * from './instructions';

package/dist/escrow/instructions.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Escrow instruction assembly — the web3.js half of the escrow layer.
+ * The rest of the SDK is web3.js-free (pure-bytes instruction DATA
+ * builders + PDA seed strings); this module derives the PDAs and wraps
+ * the data in `TransactionInstruction`s with the exact account lists
+ * from the pinned IDL.
+ *
+ * `@solana/web3.js` is a PEER dependency — only consumers that build
+ * on-chain transactions (the CLI, the server's dispute signer) pull it
+ * in; the crypto/encoding surface of the SDK stays web3.js-free.
+ *
+ * All builders are PURE (no RPC). Callers that need on-chain context
+ * (the Lock's payer/payee/mint/fee_recipient for the claim paths) use
+ * `fetchLockAccount` first and feed the decoded fields in.
+ *
+ * Account orders are BYTE-LAW — they mirror the pinned IDL exactly;
+ * reordering = on-chain ConstraintSeeds reject. This is the single
+ * source of truth shared by every consumer; do not duplicate it.
+ */
+import { type Connection, PublicKey, TransactionInstruction } from '@solana/web3.js';
+import { type ResolveDisputeArgs } from './lifecycle-instructions';
+import { type DecodedLockAccount } from './lock-account';
+export declare const SPL_TOKEN_PROGRAM_ID: PublicKey;
+export declare const ASSOCIATED_TOKEN_PROGRAM_ID: PublicKey;
+/** The contract's native-SOL sentinel as a PublicKey ([0u8;32]). */
+export declare const NATIVE_SOL_MINT: PublicKey;
+export declare function deriveLockPda(programId: PublicKey, lockId: Uint8Array): PublicKey;
+export declare function deriveEscrowPda(programId: PublicKey, lockId: Uint8Array): PublicKey;
+export declare function deriveConfigPda(programId: PublicKey): PublicKey;
+export declare function deriveStakeVaultPda(programId: PublicKey): PublicKey;
+/** Native locks use the all-zero sentinel as the collateral seed. */
+export declare function deriveCollateralConfigPda(programId: PublicKey, mint: PublicKey): PublicKey;
+export declare function deriveDisputeResolutionPda(programId: PublicKey, lockId: Uint8Array): PublicKey;
+export declare function deriveOperatorAuthPda(programId: PublicKey, operator: PublicKey): PublicKey;
+export declare function deriveEventAuthorityPda(programId: PublicKey): PublicKey;
+/** Associated token account for (owner, mint) under the legacy SPL Token program. */
+export declare function deriveAta(owner: PublicKey, mint: PublicKey): PublicKey;
+interface Ctx {
+    programId: PublicKey;
+    lockId: Uint8Array;
+}
+export interface CreateLockIxInput extends Ctx {
+    payer: PublicKey;
+    payee: PublicKey;
+    amount: bigint;
+    conditionHash: Uint8Array;
+    /** null → native SOL (`create_lock_native`). */
+    mint: PublicKey | null;
+}
+export declare function buildCreateLockIx(input: CreateLockIxInput): TransactionInstruction;
+export interface AcceptLockIxInput extends Ctx {
+    payee: PublicKey;
+}
+export declare function buildAcceptLockIx(input: AcceptLockIxInput): TransactionInstruction;
+export interface SubmitWorkIxInput extends Ctx {
+    payee: PublicKey;
+}
+export declare function buildSubmitWorkIx(input: SubmitWorkIxInput): TransactionInstruction;
+export interface ClaimWorkPaymentIxInput extends Ctx {
+    /** The tx sender: payer (buyer approval) or payee (post-review self-claim). */
+    authority: PublicKey;
+    payer: PublicKey;
+    payee: PublicKey;
+    /** null → native. */
+    mint: PublicKey | null;
+    feeRecipient: PublicKey;
+}
+export declare function buildClaimWorkPaymentIx(input: ClaimWorkPaymentIxInput): TransactionInstruction;
+export interface CancelLockIxInput extends Ctx {
+    payer: PublicKey;
+    mint: PublicKey | null;
+}
+export declare function buildCancelLockIx(input: CancelLockIxInput): TransactionInstruction;
+export interface ClaimExpiredWorkIxInput extends Ctx {
+    payer: PublicKey;
+    mint: PublicKey | null;
+}
+export declare function buildClaimExpiredWorkIx(input: ClaimExpiredWorkIxInput): TransactionInstruction;
+export interface OpenDisputeIxInput extends Ctx {
+    payer: PublicKey;
+}
+export declare function buildOpenDisputeIx(input: OpenDisputeIxInput): TransactionInstruction;
+export interface ResolveDisputeIxInput extends Ctx {
+    operator: PublicKey;
+    payer: PublicKey;
+    /** The ruled winner (payer or payee — must agree with args.isPayerWinner). */
+    winner: PublicKey;
+    feeRecipient: PublicKey;
+    treasury: PublicKey;
+    mint: PublicKey | null;
+    args: ResolveDisputeArgs;
+}
+export declare function buildResolveDisputeIx(input: ResolveDisputeIxInput): TransactionInstruction;
+export interface CloseDisputeIxInput extends Ctx {
+    /** Either party — after the dispute window lapses unresolved. */
+    authority: PublicKey;
+    payer: PublicKey;
+    payee: PublicKey;
+    mint: PublicKey | null;
+}
+export declare function buildCloseDisputeIx(input: CloseDisputeIxInput): TransactionInstruction;
+/**
+ * Fetch + decode the Lock account for a delegation. Returns `null`
+ * when the lock PDA doesn't exist (never created, or wrong cluster /
+ * program id — the caller distinguishes via its own context).
+ */
+export declare function fetchLockAccount(conn: Connection, programId: PublicKey, delegationId: string): Promise<{
+    lockId: Uint8Array;
+    lockPda: PublicKey;
+    lock: DecodedLockAccount;
+} | null>;
+export {};

package/dist/index.js

@@ -7,6 +7,7 @@ var base = require('@scure/base');
 var ed = require('@noble/ed25519');
 var hmac = require('@noble/hashes/hmac');
 var scrypt = require('@noble/hashes/scrypt');
+var web3_js = require('@solana/web3.js');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -941,6 +942,270 @@ function readU64LE(buf, off) {
   }
   return v;
 }
+var SPL_TOKEN_PROGRAM_ID = new web3_js.PublicKey(SPL_TOKEN_PROGRAM_ID_BASE58);
+var ASSOCIATED_TOKEN_PROGRAM_ID = new web3_js.PublicKey(ASSOCIATED_TOKEN_PROGRAM_ID_BASE58);
+var NATIVE_SOL_MINT = new web3_js.PublicKey(NATIVE_SOL_MINT_BASE58);
+function deriveLockPda(programId, lockId) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.LOCK), Buffer.from(lockId)], programId)[0];
+}
+function deriveEscrowPda(programId, lockId) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.ESCROW), Buffer.from(lockId)], programId)[0];
+}
+function deriveConfigPda(programId) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.CONFIG)], programId)[0];
+}
+function deriveStakeVaultPda(programId) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.STAKE_VAULT)], programId)[0];
+}
+function deriveCollateralConfigPda(programId, mint) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.COLLATERAL), mint.toBuffer()], programId)[0];
+}
+function deriveDisputeResolutionPda(programId, lockId) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.DISPUTE_RESOLUTION), Buffer.from(lockId)], programId)[0];
+}
+function deriveOperatorAuthPda(programId, operator) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.OPERATOR_AUTH), operator.toBuffer()], programId)[0];
+}
+function deriveEventAuthorityPda(programId) {
+  return web3_js.PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.EVENT_AUTHORITY)], programId)[0];
+}
+function deriveAta(owner, mint) {
+  return web3_js.PublicKey.findProgramAddressSync([owner.toBuffer(), SPL_TOKEN_PROGRAM_ID.toBuffer(), mint.toBuffer()], ASSOCIATED_TOKEN_PROGRAM_ID)[0];
+}
+function eventCpiTail(programId) {
+  return [
+    { pubkey: deriveEventAuthorityPda(programId), isSigner: false, isWritable: false },
+    { pubkey: programId, isSigner: false, isWritable: false }
+  ];
+}
+function meta(pubkey, opts = {}) {
+  return { pubkey, isSigner: opts.signer === true, isWritable: opts.writable === true };
+}
+function noArgIx(programId, name, keys) {
+  return new web3_js.TransactionInstruction({ programId, keys, data: Buffer.from(buildLifecycleIxData(name)) });
+}
+function buildCreateLockIx(input) {
+  const { programId, lockId } = input;
+  const native = input.mint === null;
+  const data = Buffer.from(buildCreateLockIxData({ lockId, amount: input.amount, conditionHash: input.conditionHash }, { native }));
+  const head = [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(input.payee),
+    meta(deriveConfigPda(programId)),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(deriveCollateralConfigPda(programId, input.mint ?? NATIVE_SOL_MINT))
+  ];
+  const keys = native ? [...head, meta(deriveEscrowPda(programId, lockId), { writable: true }), meta(web3_js.SystemProgram.programId), ...eventCpiTail(programId)] : [
+    ...head,
+    meta(input.mint),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(web3_js.SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ];
+  return new web3_js.TransactionInstruction({ programId, keys, data });
+}
+function buildAcceptLockIx(input) {
+  const { programId, lockId } = input;
+  return noArgIx(programId, "accept_lock", [
+    meta(input.payee, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(web3_js.SystemProgram.programId),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildSubmitWorkIx(input) {
+  const { programId, lockId } = input;
+  return noArgIx(programId, "submit_work", [
+    meta(input.payee, { signer: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildClaimWorkPaymentIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "claim_work_payment_native", [
+      meta(input.authority, { signer: true, writable: true }),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(input.payer, { writable: true }),
+      meta(input.payee, { writable: true }),
+      meta(input.feeRecipient, { writable: true }),
+      meta(web3_js.SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "claim_work_payment", [
+    meta(input.authority, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(input.payer, { writable: true }),
+    meta(input.payee, { writable: true }),
+    meta(deriveAta(input.payee, input.mint), { writable: true }),
+    meta(input.feeRecipient),
+    meta(deriveAta(input.feeRecipient, input.mint), { writable: true }),
+    meta(web3_js.SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildCancelLockIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "cancel_lock_native", [
+      meta(input.payer, { signer: true, writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(web3_js.SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "cancel_lock", [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(web3_js.SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildClaimExpiredWorkIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "claim_expired_work_native", [
+      meta(input.payer, { signer: true, writable: true }),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(web3_js.SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "claim_expired_work", [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(web3_js.SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildOpenDisputeIx(input) {
+  const { programId, lockId } = input;
+  return noArgIx(programId, "open_dispute", [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(web3_js.SystemProgram.programId),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildResolveDisputeIx(input) {
+  const { programId, lockId } = input;
+  const native = input.mint === null;
+  const data = Buffer.from(buildResolveDisputeIxData(input.args, { native }));
+  if (native) {
+    return new web3_js.TransactionInstruction({
+      programId,
+      data,
+      keys: [
+        meta(input.operator, { signer: true, writable: true }),
+        meta(deriveOperatorAuthPda(programId, input.operator)),
+        meta(deriveStakeVaultPda(programId), { writable: true }),
+        meta(deriveLockPda(programId, lockId), { writable: true }),
+        meta(deriveDisputeResolutionPda(programId, lockId), { writable: true }),
+        meta(deriveEscrowPda(programId, lockId), { writable: true }),
+        meta(input.payer, { writable: true }),
+        meta(input.winner, { writable: true }),
+        meta(input.feeRecipient, { writable: true }),
+        meta(input.treasury, { writable: true }),
+        meta(web3_js.SystemProgram.programId),
+        ...eventCpiTail(programId)
+      ]
+    });
+  }
+  return new web3_js.TransactionInstruction({
+    programId,
+    data,
+    keys: [
+      meta(input.operator, { signer: true, writable: true }),
+      meta(deriveOperatorAuthPda(programId, input.operator)),
+      meta(deriveConfigPda(programId)),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveDisputeResolutionPda(programId, lockId), { writable: true }),
+      meta(input.mint),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(input.payer, { writable: true }),
+      meta(input.winner, { writable: true }),
+      meta(deriveAta(input.winner, input.mint), { writable: true }),
+      meta(input.feeRecipient),
+      meta(deriveAta(input.feeRecipient, input.mint), { writable: true }),
+      meta(input.treasury, { writable: true }),
+      meta(web3_js.SystemProgram.programId),
+      meta(SPL_TOKEN_PROGRAM_ID),
+      meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+      ...eventCpiTail(programId)
+    ]
+  });
+}
+function buildCloseDisputeIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "close_dispute_native", [
+      meta(input.authority, { signer: true, writable: true }),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(input.payer, { writable: true }),
+      meta(input.payee, { writable: true }),
+      meta(web3_js.SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "close_dispute", [
+    meta(input.authority, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(input.payer, { writable: true }),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(input.payee, { writable: true }),
+    meta(web3_js.SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+async function fetchLockAccount(conn, programId, delegationId) {
+  const lockId = deriveLockId(delegationId);
+  const lockPda = deriveLockPda(programId, lockId);
+  const info = await conn.getAccountInfo(lockPda);
+  if (!info) return null;
+  return { lockId, lockPda, lock: decodeLockAccount(Uint8Array.from(info.data)) };
+}
 
 // src/errors/post-commit.ts
 var POST_COMMIT_ERROR_CODES = [
@@ -1005,6 +1270,7 @@ exports.ASSET_DECIMALS_MIN = ASSET_DECIMALS_MIN;
 exports.ASSET_SYMBOL_MAX_LEN = ASSET_SYMBOL_MAX_LEN;
 exports.ASSET_SYMBOL_MIN_LEN = ASSET_SYMBOL_MIN_LEN;
 exports.ASSET_WHITELIST = ASSET_WHITELIST;
+exports.ASSOCIATED_TOKEN_PROGRAM_ID = ASSOCIATED_TOKEN_PROGRAM_ID;
 exports.ASSOCIATED_TOKEN_PROGRAM_ID_BASE58 = ASSOCIATED_TOKEN_PROGRAM_ID_BASE58;
 exports.BODY_TYPES = BODY_TYPES;
 exports.BodyTypes = BodyTypes;
@@ -1049,6 +1315,7 @@ exports.LockTerminalStates = LockTerminalStates;
 exports.MAINNET_MINTS = MAINNET_MINTS;
 exports.MAX_CLOCK_SKEW_SECONDS = MAX_CLOCK_SKEW_SECONDS;
 exports.MAX_ENVELOPE_TTL_SECONDS = MAX_ENVELOPE_TTL_SECONDS;
+exports.NATIVE_SOL_MINT = NATIVE_SOL_MINT;
 exports.NATIVE_SOL_MINT_BASE58 = NATIVE_SOL_MINT_BASE58;
 exports.NO_ARG_LIFECYCLE_INSTRUCTIONS = NO_ARG_LIFECYCLE_INSTRUCTIONS;
 exports.OWNER_SIGNING_METHODS = OWNER_SIGNING_METHODS;
@@ -1067,6 +1334,7 @@ exports.SCRYPT_PARAMS = SCRYPT_PARAMS;
 exports.SHA256_HEX_RE = SHA256_HEX_RE;
 exports.SLIP44_SOLANA = SLIP44_SOLANA;
 exports.SOLANA_CLUSTER_IDS = SOLANA_CLUSTER_IDS;
+exports.SPL_TOKEN_PROGRAM_ID = SPL_TOKEN_PROGRAM_ID;
 exports.SPL_TOKEN_PROGRAM_ID_BASE58 = SPL_TOKEN_PROGRAM_ID_BASE58;
 exports.SYSTEM_PROGRAM_ID_BASE58 = SYSTEM_PROGRAM_ID_BASE58;
 exports.TOKEN_2022_PROGRAM_ID_BASE58 = TOKEN_2022_PROGRAM_ID_BASE58;
@@ -1076,9 +1344,18 @@ exports.WORK_LOG_STATES = WORK_LOG_STATES;
 exports.WorkLogStates = WorkLogStates;
 exports.base58btcDecode = base58btcDecode;
 exports.base58btcEncode = base58btcEncode;
+exports.buildAcceptLockIx = buildAcceptLockIx;
+exports.buildCancelLockIx = buildCancelLockIx;
+exports.buildClaimExpiredWorkIx = buildClaimExpiredWorkIx;
+exports.buildClaimWorkPaymentIx = buildClaimWorkPaymentIx;
+exports.buildCloseDisputeIx = buildCloseDisputeIx;
+exports.buildCreateLockIx = buildCreateLockIx;
 exports.buildCreateLockIxData = buildCreateLockIxData;
 exports.buildLifecycleIxData = buildLifecycleIxData;
+exports.buildOpenDisputeIx = buildOpenDisputeIx;
+exports.buildResolveDisputeIx = buildResolveDisputeIx;
 exports.buildResolveDisputeIxData = buildResolveDisputeIxData;
+exports.buildSubmitWorkIx = buildSubmitWorkIx;
 exports.bytes16ToDelegationId = bytes16ToDelegationId;
 exports.canonicalBytes = canonicalBytes;
 exports.canonicalJson = canonicalJson;
@@ -1087,12 +1364,22 @@ exports.computeCreateLockDiscriminator = computeCreateLockDiscriminator;
 exports.computeLockAccountDiscriminator = computeLockAccountDiscriminator;
 exports.decodeLockAccount = decodeLockAccount;
 exports.delegationIdToBytes16 = delegationIdToBytes16;
+exports.deriveAta = deriveAta;
+exports.deriveCollateralConfigPda = deriveCollateralConfigPda;
+exports.deriveConfigPda = deriveConfigPda;
 exports.deriveDelegationConditionHash = deriveDelegationConditionHash;
+exports.deriveDisputeResolutionPda = deriveDisputeResolutionPda;
+exports.deriveEscrowPda = deriveEscrowPda;
+exports.deriveEventAuthorityPda = deriveEventAuthorityPda;
 exports.deriveLockId = deriveLockId;
+exports.deriveLockPda = deriveLockPda;
+exports.deriveOperatorAuthPda = deriveOperatorAuthPda;
 exports.deriveScryptKey = deriveScryptKey;
+exports.deriveStakeVaultPda = deriveStakeVaultPda;
 exports.detectTokenProgramFromOwner = detectTokenProgramFromOwner;
 exports.detectTokenProgramFromOwnerBytes = detectTokenProgramFromOwnerBytes;
 exports.expiresAt = expiresAt;
+exports.fetchLockAccount = fetchLockAccount;
 exports.findAssetByAssetId = findAssetByAssetId;
 exports.findFirstChainDivergence = findFirstChainDivergence;
 exports.formatDid = formatDid;

package/dist/index.mjs

@@ -5,6 +5,7 @@ import { base58, base64, base64urlnopad } from '@scure/base';
 import * as ed from '@noble/ed25519';
 import { hmac } from '@noble/hashes/hmac';
 import { scrypt } from '@noble/hashes/scrypt';
+import { PublicKey, SystemProgram, TransactionInstruction } from '@solana/web3.js';
 
 // src/canonical/canonicalize.ts
 function canonicalJson(value) {
@@ -916,6 +917,270 @@ function readU64LE(buf, off) {
   }
   return v;
 }
+var SPL_TOKEN_PROGRAM_ID = new PublicKey(SPL_TOKEN_PROGRAM_ID_BASE58);
+var ASSOCIATED_TOKEN_PROGRAM_ID = new PublicKey(ASSOCIATED_TOKEN_PROGRAM_ID_BASE58);
+var NATIVE_SOL_MINT = new PublicKey(NATIVE_SOL_MINT_BASE58);
+function deriveLockPda(programId, lockId) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.LOCK), Buffer.from(lockId)], programId)[0];
+}
+function deriveEscrowPda(programId, lockId) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.ESCROW), Buffer.from(lockId)], programId)[0];
+}
+function deriveConfigPda(programId) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.CONFIG)], programId)[0];
+}
+function deriveStakeVaultPda(programId) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.STAKE_VAULT)], programId)[0];
+}
+function deriveCollateralConfigPda(programId, mint) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.COLLATERAL), mint.toBuffer()], programId)[0];
+}
+function deriveDisputeResolutionPda(programId, lockId) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.DISPUTE_RESOLUTION), Buffer.from(lockId)], programId)[0];
+}
+function deriveOperatorAuthPda(programId, operator) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.OPERATOR_AUTH), operator.toBuffer()], programId)[0];
+}
+function deriveEventAuthorityPda(programId) {
+  return PublicKey.findProgramAddressSync([Buffer.from(ESCROW_PDA_SEEDS.EVENT_AUTHORITY)], programId)[0];
+}
+function deriveAta(owner, mint) {
+  return PublicKey.findProgramAddressSync([owner.toBuffer(), SPL_TOKEN_PROGRAM_ID.toBuffer(), mint.toBuffer()], ASSOCIATED_TOKEN_PROGRAM_ID)[0];
+}
+function eventCpiTail(programId) {
+  return [
+    { pubkey: deriveEventAuthorityPda(programId), isSigner: false, isWritable: false },
+    { pubkey: programId, isSigner: false, isWritable: false }
+  ];
+}
+function meta(pubkey, opts = {}) {
+  return { pubkey, isSigner: opts.signer === true, isWritable: opts.writable === true };
+}
+function noArgIx(programId, name, keys) {
+  return new TransactionInstruction({ programId, keys, data: Buffer.from(buildLifecycleIxData(name)) });
+}
+function buildCreateLockIx(input) {
+  const { programId, lockId } = input;
+  const native = input.mint === null;
+  const data = Buffer.from(buildCreateLockIxData({ lockId, amount: input.amount, conditionHash: input.conditionHash }, { native }));
+  const head = [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(input.payee),
+    meta(deriveConfigPda(programId)),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(deriveCollateralConfigPda(programId, input.mint ?? NATIVE_SOL_MINT))
+  ];
+  const keys = native ? [...head, meta(deriveEscrowPda(programId, lockId), { writable: true }), meta(SystemProgram.programId), ...eventCpiTail(programId)] : [
+    ...head,
+    meta(input.mint),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ];
+  return new TransactionInstruction({ programId, keys, data });
+}
+function buildAcceptLockIx(input) {
+  const { programId, lockId } = input;
+  return noArgIx(programId, "accept_lock", [
+    meta(input.payee, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(SystemProgram.programId),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildSubmitWorkIx(input) {
+  const { programId, lockId } = input;
+  return noArgIx(programId, "submit_work", [
+    meta(input.payee, { signer: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildClaimWorkPaymentIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "claim_work_payment_native", [
+      meta(input.authority, { signer: true, writable: true }),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(input.payer, { writable: true }),
+      meta(input.payee, { writable: true }),
+      meta(input.feeRecipient, { writable: true }),
+      meta(SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "claim_work_payment", [
+    meta(input.authority, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(input.payer, { writable: true }),
+    meta(input.payee, { writable: true }),
+    meta(deriveAta(input.payee, input.mint), { writable: true }),
+    meta(input.feeRecipient),
+    meta(deriveAta(input.feeRecipient, input.mint), { writable: true }),
+    meta(SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildCancelLockIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "cancel_lock_native", [
+      meta(input.payer, { signer: true, writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "cancel_lock", [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildClaimExpiredWorkIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "claim_expired_work_native", [
+      meta(input.payer, { signer: true, writable: true }),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "claim_expired_work", [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildOpenDisputeIx(input) {
+  const { programId, lockId } = input;
+  return noArgIx(programId, "open_dispute", [
+    meta(input.payer, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(SystemProgram.programId),
+    ...eventCpiTail(programId)
+  ]);
+}
+function buildResolveDisputeIx(input) {
+  const { programId, lockId } = input;
+  const native = input.mint === null;
+  const data = Buffer.from(buildResolveDisputeIxData(input.args, { native }));
+  if (native) {
+    return new TransactionInstruction({
+      programId,
+      data,
+      keys: [
+        meta(input.operator, { signer: true, writable: true }),
+        meta(deriveOperatorAuthPda(programId, input.operator)),
+        meta(deriveStakeVaultPda(programId), { writable: true }),
+        meta(deriveLockPda(programId, lockId), { writable: true }),
+        meta(deriveDisputeResolutionPda(programId, lockId), { writable: true }),
+        meta(deriveEscrowPda(programId, lockId), { writable: true }),
+        meta(input.payer, { writable: true }),
+        meta(input.winner, { writable: true }),
+        meta(input.feeRecipient, { writable: true }),
+        meta(input.treasury, { writable: true }),
+        meta(SystemProgram.programId),
+        ...eventCpiTail(programId)
+      ]
+    });
+  }
+  return new TransactionInstruction({
+    programId,
+    data,
+    keys: [
+      meta(input.operator, { signer: true, writable: true }),
+      meta(deriveOperatorAuthPda(programId, input.operator)),
+      meta(deriveConfigPda(programId)),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveDisputeResolutionPda(programId, lockId), { writable: true }),
+      meta(input.mint),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(input.payer, { writable: true }),
+      meta(input.winner, { writable: true }),
+      meta(deriveAta(input.winner, input.mint), { writable: true }),
+      meta(input.feeRecipient),
+      meta(deriveAta(input.feeRecipient, input.mint), { writable: true }),
+      meta(input.treasury, { writable: true }),
+      meta(SystemProgram.programId),
+      meta(SPL_TOKEN_PROGRAM_ID),
+      meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+      ...eventCpiTail(programId)
+    ]
+  });
+}
+function buildCloseDisputeIx(input) {
+  const { programId, lockId } = input;
+  if (input.mint === null) {
+    return noArgIx(programId, "close_dispute_native", [
+      meta(input.authority, { signer: true, writable: true }),
+      meta(deriveStakeVaultPda(programId), { writable: true }),
+      meta(deriveLockPda(programId, lockId), { writable: true }),
+      meta(deriveEscrowPda(programId, lockId), { writable: true }),
+      meta(input.payer, { writable: true }),
+      meta(input.payee, { writable: true }),
+      meta(SystemProgram.programId),
+      ...eventCpiTail(programId)
+    ]);
+  }
+  return noArgIx(programId, "close_dispute", [
+    meta(input.authority, { signer: true, writable: true }),
+    meta(deriveConfigPda(programId)),
+    meta(deriveStakeVaultPda(programId), { writable: true }),
+    meta(deriveLockPda(programId, lockId), { writable: true }),
+    meta(input.mint),
+    meta(deriveEscrowPda(programId, lockId), { writable: true }),
+    meta(input.payer, { writable: true }),
+    meta(deriveAta(input.payer, input.mint), { writable: true }),
+    meta(input.payee, { writable: true }),
+    meta(SystemProgram.programId),
+    meta(SPL_TOKEN_PROGRAM_ID),
+    meta(ASSOCIATED_TOKEN_PROGRAM_ID),
+    ...eventCpiTail(programId)
+  ]);
+}
+async function fetchLockAccount(conn, programId, delegationId) {
+  const lockId = deriveLockId(delegationId);
+  const lockPda = deriveLockPda(programId, lockId);
+  const info = await conn.getAccountInfo(lockPda);
+  if (!info) return null;
+  return { lockId, lockPda, lock: decodeLockAccount(Uint8Array.from(info.data)) };
+}
 
 // src/errors/post-commit.ts
 var POST_COMMIT_ERROR_CODES = [
@@ -973,4 +1238,4 @@ var CliAuthTokenErrorCodes = {
   REQUIRED: "AUTH_TOKEN_REQUIRED"
 };
 
-export { AGENT_NAME_REGEX, AGENT_TAG_REGEX, ASSET_DECIMALS_MAX, ASSET_DECIMALS_MIN, ASSET_SYMBOL_MAX_LEN, ASSET_SYMBOL_MIN_LEN, ASSET_WHITELIST, ASSOCIATED_TOKEN_PROGRAM_ID_BASE58, BODY_TYPES, BodyTypes, CAIP19_REGEX, CLI_AUTH_TOKEN_ERROR_CODES, CLI_LOGIN_SESSION_STATES, CLI_LOGIN_SESSION_STORED_STATES, CREATE_LOCK_DISCRIMINATOR, CREATE_LOCK_NATIVE_DISCRIMINATOR, CURRENT_PROTOCOL_VERSION, CliAuthTokenErrorCodes, CliLoginSessionStates, DECIMAL_AMOUNT_REGEX, DECLINE_REASONS, DELEGATION_ACTIONS, DELEGATION_ACTIVE_STATES, DELEGATION_OFFER_REJECTION_CODES, DELEGATION_STATES, DEVNET_MINTS, DID_ARP_REGEX, DISCOVERY_SORTS, DelegationActions, DelegationOfferRejectionCodes, DelegationStates, DiscoverySorts, ED25519_SIG_PREFIX, ESCROW_PDA_SEEDS, ESCROW_PROGRAM_ID_BASE58, ESCROW_RELEASE_METHODS, EscrowReleaseMethods, HANDSHAKE_DECISIONS, HandshakeDecisions, INBOX_BLOCK_SCOPES, InboxBlockScopes, LIVE_RELATIONSHIP_STATE_NAMES, LOCK_ACCOUNT_DISCRIMINATOR, LOCK_ACCOUNT_SIZE, LOCK_STATE_NAMES, LOCK_TERMINAL_STATES, LockStates, LockTerminalStates, MAINNET_MINTS, MAX_CLOCK_SKEW_SECONDS, MAX_ENVELOPE_TTL_SECONDS, NATIVE_SOL_MINT_BASE58, NO_ARG_LIFECYCLE_INSTRUCTIONS, OWNER_SIGNING_METHODS, POST_COMMIT_ERROR_CODES, POST_COMMIT_ERROR_CODE_PREFIXES, PROTOCOL_VERSIONS, Purpose, READ_MODEL_STATUSES, RECEIPT_VERDICTS, RELATIONSHIP_STATE_NAMES, RESERVED_NAMES, ReadModelStatuses, ReceiptVerdicts, RelationshipStates, SCRYPT_PARAMS, SHA256_HEX_RE, SLIP44_SOLANA, SOLANA_CLUSTER_IDS, SPL_TOKEN_PROGRAM_ID_BASE58, SYSTEM_PROGRAM_ID_BASE58, TOKEN_2022_PROGRAM_ID_BASE58, WELL_KNOWN_ASSETS, WELL_KNOWN_ASSET_KEYS, WORK_LOG_STATES, WorkLogStates, base58btcDecode, base58btcEncode, buildCreateLockIxData, buildLifecycleIxData, buildResolveDisputeIxData, bytes16ToDelegationId, canonicalBytes, canonicalJson, canonicalSha256Hex, computeCreateLockDiscriminator, computeLockAccountDiscriminator, decodeLockAccount, delegationIdToBytes16, deriveDelegationConditionHash, deriveLockId, deriveScryptKey, detectTokenProgramFromOwner, detectTokenProgramFromOwnerBytes, expiresAt, findAssetByAssetId, findFirstChainDivergence, formatDid, generateKeyPair, getPublicKey2 as getPublicKey, instructionDiscriminator, isAssetIdentifier, isBodyType, isCliLoginSessionWireState, isDecimalAmountString, isDeclineReason, isDelegationAction, isDelegationState, isDiscoverySort, isEscrowReleaseMethod, isHandshakeDecision, isInboxBlockScope, isPostCommitErrorCode, isReadModelStatus, isReceiptVerdict, isRelationshipState, isReservedName, isSha256Hex, isValidAgentName, isValidDid, isWhitelistedAssetId, isWorkLogState, listWhitelistedAssets, normalizeName, parseCaip19SolanaAssetId, parseDid, pollUntil, resolveAsset, rfc3339, scryptPasswordProofSign, scryptPasswordProofVerify, senderNonce, serverEventHash, sign2 as sign, signChallenge, signEnvelope, signKeyLinkAttestation, signedMessageHash, uuidV4, verify2 as verify, verifyChallenge, verifyEnvelope, verifyKeyLinkAttestation };
+export { AGENT_NAME_REGEX, AGENT_TAG_REGEX, ASSET_DECIMALS_MAX, ASSET_DECIMALS_MIN, ASSET_SYMBOL_MAX_LEN, ASSET_SYMBOL_MIN_LEN, ASSET_WHITELIST, ASSOCIATED_TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID_BASE58, BODY_TYPES, BodyTypes, CAIP19_REGEX, CLI_AUTH_TOKEN_ERROR_CODES, CLI_LOGIN_SESSION_STATES, CLI_LOGIN_SESSION_STORED_STATES, CREATE_LOCK_DISCRIMINATOR, CREATE_LOCK_NATIVE_DISCRIMINATOR, CURRENT_PROTOCOL_VERSION, CliAuthTokenErrorCodes, CliLoginSessionStates, DECIMAL_AMOUNT_REGEX, DECLINE_REASONS, DELEGATION_ACTIONS, DELEGATION_ACTIVE_STATES, DELEGATION_OFFER_REJECTION_CODES, DELEGATION_STATES, DEVNET_MINTS, DID_ARP_REGEX, DISCOVERY_SORTS, DelegationActions, DelegationOfferRejectionCodes, DelegationStates, DiscoverySorts, ED25519_SIG_PREFIX, ESCROW_PDA_SEEDS, ESCROW_PROGRAM_ID_BASE58, ESCROW_RELEASE_METHODS, EscrowReleaseMethods, HANDSHAKE_DECISIONS, HandshakeDecisions, INBOX_BLOCK_SCOPES, InboxBlockScopes, LIVE_RELATIONSHIP_STATE_NAMES, LOCK_ACCOUNT_DISCRIMINATOR, LOCK_ACCOUNT_SIZE, LOCK_STATE_NAMES, LOCK_TERMINAL_STATES, LockStates, LockTerminalStates, MAINNET_MINTS, MAX_CLOCK_SKEW_SECONDS, MAX_ENVELOPE_TTL_SECONDS, NATIVE_SOL_MINT, NATIVE_SOL_MINT_BASE58, NO_ARG_LIFECYCLE_INSTRUCTIONS, OWNER_SIGNING_METHODS, POST_COMMIT_ERROR_CODES, POST_COMMIT_ERROR_CODE_PREFIXES, PROTOCOL_VERSIONS, Purpose, READ_MODEL_STATUSES, RECEIPT_VERDICTS, RELATIONSHIP_STATE_NAMES, RESERVED_NAMES, ReadModelStatuses, ReceiptVerdicts, RelationshipStates, SCRYPT_PARAMS, SHA256_HEX_RE, SLIP44_SOLANA, SOLANA_CLUSTER_IDS, SPL_TOKEN_PROGRAM_ID, SPL_TOKEN_PROGRAM_ID_BASE58, SYSTEM_PROGRAM_ID_BASE58, TOKEN_2022_PROGRAM_ID_BASE58, WELL_KNOWN_ASSETS, WELL_KNOWN_ASSET_KEYS, WORK_LOG_STATES, WorkLogStates, base58btcDecode, base58btcEncode, buildAcceptLockIx, buildCancelLockIx, buildClaimExpiredWorkIx, buildClaimWorkPaymentIx, buildCloseDisputeIx, buildCreateLockIx, buildCreateLockIxData, buildLifecycleIxData, buildOpenDisputeIx, buildResolveDisputeIx, buildResolveDisputeIxData, buildSubmitWorkIx, bytes16ToDelegationId, canonicalBytes, canonicalJson, canonicalSha256Hex, computeCreateLockDiscriminator, computeLockAccountDiscriminator, decodeLockAccount, delegationIdToBytes16, deriveAta, deriveCollateralConfigPda, deriveConfigPda, deriveDelegationConditionHash, deriveDisputeResolutionPda, deriveEscrowPda, deriveEventAuthorityPda, deriveLockId, deriveLockPda, deriveOperatorAuthPda, deriveScryptKey, deriveStakeVaultPda, detectTokenProgramFromOwner, detectTokenProgramFromOwnerBytes, expiresAt, fetchLockAccount, findAssetByAssetId, findFirstChainDivergence, formatDid, generateKeyPair, getPublicKey2 as getPublicKey, instructionDiscriminator, isAssetIdentifier, isBodyType, isCliLoginSessionWireState, isDecimalAmountString, isDeclineReason, isDelegationAction, isDelegationState, isDiscoverySort, isEscrowReleaseMethod, isHandshakeDecision, isInboxBlockScope, isPostCommitErrorCode, isReadModelStatus, isReceiptVerdict, isRelationshipState, isReservedName, isSha256Hex, isValidAgentName, isValidDid, isWhitelistedAssetId, isWorkLogState, listWhitelistedAssets, normalizeName, parseCaip19SolanaAssetId, parseDid, pollUntil, resolveAsset, rfc3339, scryptPasswordProofSign, scryptPasswordProofVerify, senderNonce, serverEventHash, sign2 as sign, signChallenge, signEnvelope, signKeyLinkAttestation, signedMessageHash, uuidV4, verify2 as verify, verifyChallenge, verifyEnvelope, verifyKeyLinkAttestation };

package/dist/types/index.d.ts

@@ -16,7 +16,7 @@ export type { InboxBlockScope, InboxBlock, BlockInboxBody } from './inbox';
 export { INBOX_BLOCK_SCOPES, InboxBlockScopes, isInboxBlockScope } from './inbox';
 export type { CliSessionCreated, CliTokenIssued, CliWhoami, MyAgentSummary, CliLoginSessionStoredState, CliLoginSessionWireState, } from './cli-auth';
 export { CLI_LOGIN_SESSION_STORED_STATES, CLI_LOGIN_SESSION_STATES, CliLoginSessionStates, isCliLoginSessionWireState } from './cli-auth';
-export type { AssetIdentifierWire, DelegationPublic, ReceiptPublic, RelationshipPublic, WorkLogPublic, EventPublic, IngestResult, SenderSequenceResponse, InboxUnblockResult, ListRelationshipsQuery, ListInboxQuery, ListEventsQuery, ListDelegationsQuery, ListWorkLogsQuery, ListReceiptsQuery, } from './read-model';
+export type { AssetIdentifierWire, DelegationPublic, DisputeResolutionPublic, ReceiptPublic, RelationshipPublic, WorkLogPublic, EventPublic, IngestResult, SenderSequenceResponse, InboxUnblockResult, ListRelationshipsQuery, ListInboxQuery, ListEventsQuery, ListDelegationsQuery, ListWorkLogsQuery, ListReceiptsQuery, } from './read-model';
 export type { AcceptPrefs, AcceptCurrency, AgentRegisteredResponse, AgentPublic, UpdateAgentBody, RegisterAgentRequest, ChallengeResponse, ReputationScores, ReputationCounters, AgentReputation, } from './agent';
 export { AGENT_TAG_REGEX, AGENT_NAME_REGEX, RESERVED_NAMES, isReservedName, isValidAgentName, normalizeName } from './agent';
 export type { OwnerSigningMethod, KeyLinkPayload, ScryptPasswordAttestation } from './identity';

package/dist/types/read-model.d.ts

@@ -217,3 +217,34 @@ export interface ListReceiptsQuery {
     after?: string;
     limit?: number;
 }
+/**
+ * Public projection of an autonomous dispute resolution — the arbiter's
+ * verdict for a disputed delegation. Returned by signed
+ * `GET /v1/escrow/disputes/:delegationId` (parties only); the server's
+ * DisputeReadService maps the `dispute_resolutions` row to this shape and the
+ * CLI consumes it. `winnerRole`/`winnerDid` are derived (payer = buyer/offerer,
+ * payee = worker/recipient); `verdictSource` is `llm` | `objective_fallback`;
+ * `solanaSignature` is the on-chain `resolve_dispute` tx. `status` /
+ * `verdictSource` are carried as strings here — they are the server-side
+ * worker-queue enums, not shared on-chain wire vocab.
+ */
+export interface DisputeResolutionPublic {
+    delegationId: string;
+    lockId: string;
+    status: string;
+    disputeId: string | null;
+    isPayerWinner: boolean | null;
+    winnerRole: 'payer' | 'payee' | null;
+    winnerDid: string | null;
+    verdictSource: string | null;
+    reasoning: string | null;
+    policyId: string | null;
+    snapshotHash: string | null;
+    reasonHashHex: string | null;
+    solanaSignature: string | null;
+    attempts: number;
+    lastError: string | null;
+    deadlineAt: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyanon-arp/sdk",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "TypeScript SDK for the Agent Relationship Protocol — canonical JSON, Ed25519 envelope sign/verify, did:arp identity, scrypt key attestation, chain-audit helpers.",
   "license": "MIT",
   "keywords": [
@@ -40,7 +40,16 @@
     "@scure/base": "^1.1.9",
     "canonicalize": "^2.0.0"
   },
+  "peerDependencies": {
+    "@solana/web3.js": "^1.98.0"
+  },
+  "peerDependenciesMeta": {
+    "@solana/web3.js": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@solana/web3.js": "^1.98.4",
     "@types/node": "^22.10.7",
     "tslib": "^2.6.2",
     "tsup": "^8.3.5",