@occa/sdk 0.4.0

package/dist/index.cjs

@@ -0,0 +1,870 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  ACCOUNT_DISCRIMINATOR: () => ACCOUNT_DISCRIMINATOR,
+  AGENT_IDENTITY_SEED: () => AGENT_IDENTITY_SEED,
+  COMPANY_SEED: () => COMPANY_SEED,
+  COMPANY_STATUS: () => COMPANY_STATUS,
+  DAILY_ANCHOR_SEED: () => DAILY_ANCHOR_SEED,
+  DEPLOYMENT_SEED: () => DEPLOYMENT_SEED,
+  DEPLOYMENT_STATUS: () => DEPLOYMENT_STATUS,
+  INSTRUCTION_DISCRIMINATOR: () => INSTRUCTION_DISCRIMINATOR,
+  MAX_LOCALE_LEN: () => MAX_LOCALE_LEN,
+  MAX_METADATA_URI_LEN: () => MAX_METADATA_URI_LEN,
+  MAX_NAME_LEN: () => MAX_NAME_LEN,
+  MAX_REPUTATION_URI_LEN: () => MAX_REPUTATION_URI_LEN,
+  MAX_ROLE_LEN: () => MAX_ROLE_LEN,
+  OPERATIONS_KIND: () => OPERATIONS_KIND,
+  OPERATIONS_SEED: () => OPERATIONS_SEED,
+  POLICY_SEED: () => POLICY_SEED,
+  PROTOCOL_FEES_SEED: () => PROTOCOL_FEES_SEED,
+  REGISTRY_PROGRAM_ID: () => REGISTRY_PROGRAM_ID,
+  REGISTRY_PROGRAM_ID_BASE58: () => REGISTRY_PROGRAM_ID_BASE58,
+  SOL_PSEUDO_MINT: () => SOL_PSEUDO_MINT,
+  TREASURY_ACCOUNT_DISCRIMINATOR: () => TREASURY_ACCOUNT_DISCRIMINATOR,
+  TREASURY_INSTRUCTION_DISCRIMINATOR: () => TREASURY_INSTRUCTION_DISCRIMINATOR,
+  TREASURY_PROGRAM_ID: () => TREASURY_PROGRAM_ID,
+  TREASURY_PROGRAM_ID_BASE58: () => TREASURY_PROGRAM_ID_BASE58,
+  TREASURY_SEED: () => TREASURY_SEED,
+  buildCloseOperationsInstruction: () => buildCloseOperationsInstruction,
+  buildCommitDailyAnchorInstruction: () => buildCommitDailyAnchorInstruction,
+  buildCreateCompanyInstruction: () => buildCreateCompanyInstruction,
+  buildCreateDeploymentInstruction: () => buildCreateDeploymentInstruction,
+  buildDisburseDiscretionaryInstruction: () => buildDisburseDiscretionaryInstruction,
+  buildDisbursePrivilegedInstruction: () => buildDisbursePrivilegedInstruction,
+  buildDisburseRoutineInstruction: () => buildDisburseRoutineInstruction,
+  buildInitProtocolFeeAccountInstruction: () => buildInitProtocolFeeAccountInstruction,
+  buildRegisterAgentIdentityInstruction: () => buildRegisterAgentIdentityInstruction,
+  buildRegisterCompanyOperationsInstruction: () => buildRegisterCompanyOperationsInstruction,
+  buildRetireDeploymentInstruction: () => buildRetireDeploymentInstruction,
+  buildRevokeOperationsInstruction: () => buildRevokeOperationsInstruction,
+  buildSetPolicyInstruction: () => buildSetPolicyInstruction,
+  buildSetReceivingAddressInstruction: () => buildSetReceivingAddressInstruction,
+  buildUpdateAgentIdentityMetadataInstruction: () => buildUpdateAgentIdentityMetadataInstruction,
+  buildUpdateCompanyMetadataInstruction: () => buildUpdateCompanyMetadataInstruction,
+  buildUpdateCompanyStatusInstruction: () => buildUpdateCompanyStatusInstruction,
+  buildUpdateDeploymentMetadataInstruction: () => buildUpdateDeploymentMetadataInstruction,
+  buildUpdateDeploymentStatusInstruction: () => buildUpdateDeploymentStatusInstruction,
+  buildUpdateOperationsCapabilityInstruction: () => buildUpdateOperationsCapabilityInstruction,
+  deriveAgentIdentityPda: () => deriveAgentIdentityPda,
+  deriveCompanyPda: () => deriveCompanyPda,
+  deriveDailyAnchorPda: () => deriveDailyAnchorPda,
+  deriveDeploymentPda: () => deriveDeploymentPda,
+  deriveOperationsPda: () => deriveOperationsPda,
+  derivePolicyPda: () => derivePolicyPda,
+  deriveProtocolFeePda: () => deriveProtocolFeePda,
+  deriveTreasuryPda: () => deriveTreasuryPda,
+  u32LeBytes: () => u32LeBytes
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/constants.ts
+var import_web3 = require("@solana/web3.js");
+var REGISTRY_PROGRAM_ID_BASE58 = "occaTHMv5eYG5aZ85jimxTvHkBfsDCvndXC6J2k8kxr";
+var REGISTRY_PROGRAM_ID = new import_web3.PublicKey(REGISTRY_PROGRAM_ID_BASE58);
+var TREASURY_PROGRAM_ID_BASE58 = "occaxyVLnurdjedWCBPrvDCCto8wGYadtTZ3nAmcVzh";
+var TREASURY_PROGRAM_ID = new import_web3.PublicKey(TREASURY_PROGRAM_ID_BASE58);
+var COMPANY_SEED = Buffer.from("company");
+var AGENT_IDENTITY_SEED = Buffer.from("agent_identity");
+var DEPLOYMENT_SEED = Buffer.from("deployment");
+var TREASURY_SEED = Buffer.from("treasury");
+var POLICY_SEED = Buffer.from("policy");
+var PROTOCOL_FEES_SEED = Buffer.from("protocol_fees");
+var OPERATIONS_SEED = Buffer.from("operations");
+var DAILY_ANCHOR_SEED = Buffer.from("daily_anchor");
+var OPERATIONS_KIND = {
+  /** Disbursement Wallet — operator-held only, signs `disburse_routine`. */
+  Disbursement: 0,
+  /** Anchor Wallet — operator+OCCA shared, signs `commit_daily_anchor`. */
+  Anchor: 1
+};
+var SOL_PSEUDO_MINT = new import_web3.PublicKey(new Uint8Array(32));
+var MAX_NAME_LEN = 64;
+var MAX_LOCALE_LEN = 8;
+var MAX_ROLE_LEN = 32;
+var MAX_METADATA_URI_LEN = 200;
+var MAX_REPUTATION_URI_LEN = 200;
+var COMPANY_STATUS = {
+  Active: 0,
+  Paused: 1
+};
+var DEPLOYMENT_STATUS = {
+  Active: 0,
+  Paused: 1,
+  /** Terminal — retired deployments cannot be reactivated. */
+  Retired: 2
+};
+var ACCOUNT_DISCRIMINATOR = {
+  AgentIdentity: Buffer.from([11, 149, 31, 27, 186, 76, 241, 72]),
+  CompanyAccount: Buffer.from([37, 215, 171, 200, 8, 141, 69, 96]),
+  Deployment: Buffer.from([66, 90, 104, 89, 183, 130, 64, 178]),
+  DailyAnchorAccount: Buffer.from([218, 106, 107, 94, 194, 48, 111, 254])
+};
+var TREASURY_ACCOUNT_DISCRIMINATOR = {
+  TreasuryAccount: Buffer.from([204, 140, 18, 173, 90, 152, 134, 123]),
+  PolicyAccount: Buffer.from([218, 201, 183, 164, 156, 127, 81, 175]),
+  ProtocolFeeAccount: Buffer.from([5, 171, 24, 9, 150, 135, 135, 201]),
+  OperationsAccount: Buffer.from([185, 55, 148, 90, 151, 227, 104, 158])
+};
+
+// src/pda.ts
+var import_web32 = require("@solana/web3.js");
+function u32LeBytes(value) {
+  if (!Number.isInteger(value) || value < 0 || value > 4294967295) {
+    throw new RangeError(`u32 out of range: ${value}`);
+  }
+  const buf = Buffer.alloc(4);
+  buf.writeUInt32LE(value, 0);
+  return buf;
+}
+function deriveCompanyPda(owner, nonce, programId = REGISTRY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [COMPANY_SEED, owner.toBuffer(), u32LeBytes(nonce)],
+    programId
+  );
+  return { pda, bump };
+}
+function deriveAgentIdentityPda(agentPubkey, programId = REGISTRY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [AGENT_IDENTITY_SEED, agentPubkey.toBuffer()],
+    programId
+  );
+  return { pda, bump };
+}
+function deriveDeploymentPda(companyPda, deploymentIndex, programId = REGISTRY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [DEPLOYMENT_SEED, companyPda.toBuffer(), u32LeBytes(deploymentIndex)],
+    programId
+  );
+  return { pda, bump };
+}
+function deriveTreasuryPda(companyPda, programId = TREASURY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [TREASURY_SEED, companyPda.toBuffer()],
+    programId
+  );
+  return { pda, bump };
+}
+function derivePolicyPda(companyPda, programId = TREASURY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [POLICY_SEED, companyPda.toBuffer()],
+    programId
+  );
+  return { pda, bump };
+}
+function deriveProtocolFeePda(programId = TREASURY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [PROTOCOL_FEES_SEED],
+    programId
+  );
+  return { pda, bump };
+}
+function deriveOperationsPda(companyPda, kind, programId = TREASURY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [OPERATIONS_SEED, companyPda.toBuffer(), Buffer.from([kind])],
+    programId
+  );
+  return { pda, bump };
+}
+function i64LeBytes(value) {
+  const buf = Buffer.alloc(8);
+  buf.writeBigInt64LE(value, 0);
+  return buf;
+}
+function deriveDailyAnchorPda(deploymentPda, dayUnix, programId = REGISTRY_PROGRAM_ID) {
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [DAILY_ANCHOR_SEED, deploymentPda.toBuffer(), i64LeBytes(dayUnix)],
+    programId
+  );
+  return { pda, bump };
+}
+
+// src/instructions.ts
+var import_web33 = require("@solana/web3.js");
+var INSTRUCTION_DISCRIMINATOR = {
+  createCompany: Buffer.from([36, 192, 217, 147, 233, 129, 198, 18]),
+  updateCompanyMetadata: Buffer.from([186, 229, 190, 16, 234, 141, 170, 89]),
+  updateCompanyStatus: Buffer.from([61, 6, 101, 120, 141, 13, 125, 75]),
+  registerAgentIdentity: Buffer.from([57, 31, 242, 205, 57, 129, 123, 35]),
+  updateAgentIdentityMetadata: Buffer.from([
+    250,
+    182,
+    24,
+    200,
+    201,
+    147,
+    60,
+    183
+  ]),
+  createDeployment: Buffer.from([55, 207, 186, 101, 21, 218, 102, 171]),
+  updateDeploymentMetadata: Buffer.from([100, 135, 41, 32, 16, 41, 29, 76]),
+  updateDeploymentStatus: Buffer.from([225, 195, 150, 254, 178, 203, 53, 147]),
+  retireDeployment: Buffer.from([45, 188, 162, 197, 136, 180, 202, 153]),
+  setReceivingAddress: Buffer.from([70, 63, 44, 87, 16, 6, 156, 200]),
+  commitDailyAnchor: Buffer.from([18, 7, 3, 65, 58, 148, 164, 0])
+};
+function encodeString(s) {
+  const utf8 = Buffer.from(s, "utf8");
+  const len = Buffer.alloc(4);
+  len.writeUInt32LE(utf8.length, 0);
+  return Buffer.concat([len, utf8]);
+}
+function encodePubkey(pk) {
+  return Buffer.from(pk.toBytes());
+}
+function encodeU8(n) {
+  if (!Number.isInteger(n) || n < 0 || n > 255) {
+    throw new RangeError(`u8 out of range: ${n}`);
+  }
+  return Buffer.from([n]);
+}
+function encodeMetadataHash(hash) {
+  if (hash.length !== 32) {
+    throw new RangeError(`metadata_hash must be 32 bytes, got ${hash.length}`);
+  }
+  return Buffer.from(hash);
+}
+function encodeOptionU32(value) {
+  if (value === null || value === void 0) {
+    return Buffer.from([0]);
+  }
+  return Buffer.concat([Buffer.from([1]), u32LeBytes(value)]);
+}
+function buildCreateCompanyInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const { pda: companyPda, bump } = deriveCompanyPda(
+    params.owner,
+    params.nonce,
+    programId
+  );
+  const { pda: treasuryPda } = deriveTreasuryPda(companyPda);
+  const { pda: policyPda } = derivePolicyPda(companyPda);
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.createCompany,
+    u32LeBytes(params.nonce),
+    encodeString(params.name),
+    encodeString(params.locale),
+    encodeString(params.metadataUri),
+    encodeMetadataHash(params.metadataHash)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    // Order MUST match registry/lib.rs `CreateCompany` accounts struct:
+    // company, owner, payer, treasury, policy, treasury_program, system_program.
+    keys: [
+      { pubkey: companyPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false },
+      { pubkey: params.payer, isSigner: true, isWritable: true },
+      { pubkey: treasuryPda, isSigner: false, isWritable: true },
+      { pubkey: policyPda, isSigner: false, isWritable: true },
+      { pubkey: TREASURY_PROGRAM_ID, isSigner: false, isWritable: false },
+      { pubkey: import_web33.SystemProgram.programId, isSigner: false, isWritable: false }
+    ],
+    data
+  });
+  return { instruction, companyPda, treasuryPda, policyPda, bump };
+}
+function buildUpdateCompanyMetadataInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.updateCompanyMetadata,
+    encodeString(params.name),
+    encodeString(params.locale),
+    encodeString(params.metadataUri),
+    encodeMetadataHash(params.metadataHash)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildUpdateCompanyStatusInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.updateCompanyStatus,
+    encodeU8(params.newStatus)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildRegisterAgentIdentityInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const { pda: identityPda, bump } = deriveAgentIdentityPda(
+    params.agentPubkey,
+    programId
+  );
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.registerAgentIdentity,
+    encodePubkey(params.agentPubkey),
+    encodeString(params.name),
+    encodeString(params.metadataUri),
+    encodeMetadataHash(params.metadataHash)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: identityPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false },
+      { pubkey: params.payer, isSigner: true, isWritable: true },
+      { pubkey: import_web33.SystemProgram.programId, isSigner: false, isWritable: false }
+    ],
+    data
+  });
+  return { instruction, identityPda, bump };
+}
+function buildUpdateAgentIdentityMetadataInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.updateAgentIdentityMetadata,
+    encodeString(params.name),
+    encodeString(params.metadataUri),
+    encodeMetadataHash(params.metadataHash)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.identityPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildCreateDeploymentInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const { pda: deploymentPda, bump } = deriveDeploymentPda(
+    params.companyPda,
+    params.deploymentIndex,
+    programId
+  );
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.createDeployment,
+    u32LeBytes(params.deploymentIndex),
+    encodeString(params.role),
+    encodeOptionU32(params.parentDeploymentIndex),
+    encodePubkey(params.adapterId),
+    encodeString(params.metadataUri),
+    encodeMetadataHash(params.metadataHash)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      // Order matches the on-chain `CreateDeployment` accounts struct.
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      { pubkey: params.identityPda, isSigner: false, isWritable: false },
+      { pubkey: params.owner, isSigner: true, isWritable: false },
+      { pubkey: deploymentPda, isSigner: false, isWritable: true },
+      { pubkey: params.payer, isSigner: true, isWritable: true },
+      { pubkey: import_web33.SystemProgram.programId, isSigner: false, isWritable: false }
+    ],
+    data
+  });
+  return { instruction, deploymentPda, bump };
+}
+function buildUpdateDeploymentMetadataInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.updateDeploymentMetadata,
+    encodeString(params.role),
+    encodeString(params.metadataUri),
+    encodeMetadataHash(params.metadataHash)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildUpdateDeploymentStatusInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.updateDeploymentStatus,
+    encodeU8(params.newStatus)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildRetireDeploymentInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false }
+    ],
+    data: Buffer.from(INSTRUCTION_DISCRIMINATOR.retireDeployment)
+  });
+  return { instruction };
+}
+function buildSetReceivingAddressInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.setReceivingAddress,
+    encodePubkey(params.newReceivingAddress)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: true },
+      { pubkey: params.owner, isSigner: true, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+var TREASURY_INSTRUCTION_DISCRIMINATOR = {
+  setPolicy: Buffer.from([40, 133, 12, 157, 235, 202, 2, 132]),
+  disburseDiscretionary: Buffer.from([102, 176, 14, 127, 210, 4, 96, 175]),
+  initProtocolFeeAccount: Buffer.from([214, 27, 184, 174, 155, 79, 141, 114]),
+  registerCompanyOperations: Buffer.from([212, 173, 142, 23, 28, 221, 55, 99]),
+  updateOperationsCapability: Buffer.from([21, 13, 197, 41, 92, 229, 142, 202]),
+  revokeOperations: Buffer.from([141, 196, 241, 103, 182, 146, 117, 183]),
+  closeOperations: Buffer.from([2, 52, 136, 225, 80, 230, 222, 120]),
+  disburseRoutine: Buffer.from([45, 152, 225, 130, 133, 73, 62, 202]),
+  disbursePrivileged: Buffer.from([173, 78, 248, 158, 76, 46, 88, 167])
+};
+function encodeU16(n) {
+  if (!Number.isInteger(n) || n < 0 || n > 65535) {
+    throw new RangeError(`u16 out of range: ${n}`);
+  }
+  const buf = Buffer.alloc(2);
+  buf.writeUInt16LE(n, 0);
+  return buf;
+}
+function encodeU64(n) {
+  if (n < 0n || n > 0xffffffffffffffffn) {
+    throw new RangeError(`u64 out of range: ${n}`);
+  }
+  const buf = Buffer.alloc(8);
+  buf.writeBigUInt64LE(n, 0);
+  return buf;
+}
+function encodeAssetBudget(b) {
+  return Buffer.concat([encodePubkey(b.mint), encodeU64(b.amount)]);
+}
+function encodeVec(items, encodeItem) {
+  return Buffer.concat([u32LeBytes(items.length), ...items.map(encodeItem)]);
+}
+function encodeOption(value, encodeSome) {
+  if (value === null || value === void 0) return Buffer.from([0]);
+  return Buffer.concat([Buffer.from([1]), encodeSome(value)]);
+}
+function buildSetPolicyInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  function encodeSecondarySigner(v) {
+    if (v === void 0) return Buffer.from([0]);
+    if (v === null) return Buffer.from([1, 0]);
+    return Buffer.concat([Buffer.from([1, 1]), encodePubkey(v)]);
+  }
+  const data = Buffer.concat([
+    TREASURY_INSTRUCTION_DISCRIMINATOR.setPolicy,
+    // 1. routine_budget_per_month: Option<Vec<AssetBudget>>
+    encodeOption(
+      params.routineBudgetPerMonth,
+      (v) => encodeVec(v, encodeAssetBudget)
+    ),
+    // 2. discretionary_budget_per_month: Option<Vec<AssetBudget>>
+    encodeOption(
+      params.discretionaryBudgetPerMonth,
+      (v) => encodeVec(v, encodeAssetBudget)
+    ),
+    // 3. privileged_threshold_lamports: Option<u64>
+    encodeOption(params.privilegedThresholdLamports, encodeU64),
+    // 4. privileged_threshold_per_token: Option<Vec<AssetBudget>>
+    encodeOption(
+      params.privilegedThresholdPerToken,
+      (v) => encodeVec(v, encodeAssetBudget)
+    ),
+    // 5. secondary_signer: Option<Option<Pubkey>>
+    encodeSecondarySigner(params.secondarySigner),
+    // 6. agent_operating_fee_bps: Option<u16>
+    encodeOption(params.agentOperatingFeeBps, encodeU16),
+    // 7. accepted_assets: Option<Vec<Pubkey>>
+    encodeOption(params.acceptedAssets, (v) => encodeVec(v, encodePubkey))
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    // Order: company, controlling_authority, treasury, policy.
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      {
+        pubkey: params.controllingAuthority,
+        isSigner: true,
+        isWritable: false
+      },
+      { pubkey: params.treasuryPda, isSigner: false, isWritable: true },
+      { pubkey: params.policyPda, isSigner: false, isWritable: true }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildDisburseDiscretionaryInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const mint = params.mint ?? SOL_PSEUDO_MINT;
+  const { pda: protocolFeePda } = deriveProtocolFeePda();
+  const data = Buffer.concat([
+    TREASURY_INSTRUCTION_DISCRIMINATOR.disburseDiscretionary,
+    encodePubkey(mint),
+    encodeU64(params.amountLamports)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    // Order: company, controlling_authority, treasury, policy,
+    // deployment, destination, protocol_fee_account.
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      {
+        pubkey: params.controllingAuthority,
+        isSigner: true,
+        isWritable: false
+      },
+      { pubkey: params.treasuryPda, isSigner: false, isWritable: true },
+      { pubkey: params.policyPda, isSigner: false, isWritable: true },
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: false },
+      { pubkey: params.destination, isSigner: false, isWritable: true },
+      { pubkey: protocolFeePda, isSigner: false, isWritable: true }
+    ],
+    data
+  });
+  return { instruction };
+}
+function encodeI64(n) {
+  const buf = Buffer.alloc(8);
+  buf.writeBigInt64LE(n, 0);
+  return buf;
+}
+function encodeBool(b) {
+  return Buffer.from([b ? 1 : 0]);
+}
+function encodeAction(disc) {
+  if (disc.length !== 8) {
+    throw new RangeError(`action_whitelist entry must be 8 bytes, got ${disc.length}`);
+  }
+  return Buffer.from(disc);
+}
+function buildInitProtocolFeeAccountInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const programAccount = params.program ?? programId;
+  const { pda: protocolFeePda } = deriveProtocolFeePda(programId);
+  const data = Buffer.concat([
+    TREASURY_INSTRUCTION_DISCRIMINATOR.initProtocolFeeAccount,
+    encodePubkey(params.governance)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: protocolFeePda, isSigner: false, isWritable: true },
+      { pubkey: params.authority, isSigner: true, isWritable: true },
+      { pubkey: programAccount, isSigner: false, isWritable: false },
+      { pubkey: params.programData, isSigner: false, isWritable: false },
+      { pubkey: import_web33.SystemProgram.programId, isSigner: false, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildRegisterCompanyOperationsInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const { pda: operationsPda } = deriveOperationsPda(
+    params.companyPda,
+    params.kind,
+    programId
+  );
+  const data = Buffer.concat([
+    TREASURY_INSTRUCTION_DISCRIMINATOR.registerCompanyOperations,
+    // kind: u8 enum byte
+    Buffer.from([params.kind]),
+    encodePubkey(params.signer),
+    encodeVec(params.actionWhitelist, encodeAction),
+    u32LeBytes(params.rateLimitPerPeriod),
+    encodeI64(params.expiryUnix)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      {
+        pubkey: params.controllingAuthority,
+        isSigner: true,
+        isWritable: false
+      },
+      { pubkey: operationsPda, isSigner: false, isWritable: true },
+      { pubkey: params.payer, isSigner: true, isWritable: true },
+      { pubkey: import_web33.SystemProgram.programId, isSigner: false, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildUpdateOperationsCapabilityInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const { pda: operationsPda } = deriveOperationsPda(
+    params.companyPda,
+    params.kind,
+    programId
+  );
+  const argBody = Buffer.concat([
+    encodeOption(params.actionWhitelist, (v) => encodeVec(v, encodeAction)),
+    encodeOption(params.rateLimitPerPeriod, u32LeBytes),
+    encodeOption(params.expiryUnix, encodeI64)
+  ]);
+  const data = Buffer.concat([
+    TREASURY_INSTRUCTION_DISCRIMINATOR.updateOperationsCapability,
+    argBody
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      {
+        pubkey: params.controllingAuthority,
+        isSigner: true,
+        isWritable: false
+      },
+      { pubkey: operationsPda, isSigner: false, isWritable: true }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildRevokeOperationsInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const { pda: operationsPda } = deriveOperationsPda(
+    params.companyPda,
+    params.kind,
+    programId
+  );
+  const data = Buffer.from(TREASURY_INSTRUCTION_DISCRIMINATOR.revokeOperations);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      {
+        pubkey: params.controllingAuthority,
+        isSigner: true,
+        isWritable: false
+      },
+      { pubkey: operationsPda, isSigner: false, isWritable: true }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildCloseOperationsInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const { pda: operationsPda } = deriveOperationsPda(
+    params.companyPda,
+    params.kind,
+    programId
+  );
+  const data = Buffer.from(TREASURY_INSTRUCTION_DISCRIMINATOR.closeOperations);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      {
+        pubkey: params.controllingAuthority,
+        isSigner: true,
+        isWritable: true
+      },
+      { pubkey: operationsPda, isSigner: false, isWritable: true }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildDisburseRoutineInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const mint = params.mint ?? SOL_PSEUDO_MINT;
+  const { pda: protocolFeePda } = deriveProtocolFeePda(programId);
+  const data = Buffer.concat([
+    TREASURY_INSTRUCTION_DISCRIMINATOR.disburseRoutine,
+    encodePubkey(mint),
+    encodeU64(params.amountLamports)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    // Order: company, treasury, policy, operations, operations_signer,
+    // deployment, destination, protocol_fee_account.
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      { pubkey: params.treasuryPda, isSigner: false, isWritable: true },
+      { pubkey: params.policyPda, isSigner: false, isWritable: true },
+      { pubkey: params.operationsPda, isSigner: false, isWritable: true },
+      { pubkey: params.operationsSigner, isSigner: true, isWritable: false },
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: false },
+      { pubkey: params.destination, isSigner: false, isWritable: true },
+      { pubkey: protocolFeePda, isSigner: false, isWritable: true }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildDisbursePrivilegedInstruction(params) {
+  const programId = params.programId ?? TREASURY_PROGRAM_ID;
+  const mint = params.mint ?? SOL_PSEUDO_MINT;
+  const { pda: protocolFeePda } = deriveProtocolFeePda(programId);
+  const data = Buffer.concat([
+    TREASURY_INSTRUCTION_DISCRIMINATOR.disbursePrivileged,
+    encodePubkey(mint),
+    encodeU64(params.amountLamports),
+    encodeBool(params.isAgentDestination)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    // Order: company, controlling_authority, secondary_signer, treasury,
+    // policy, deployment, destination, protocol_fee_account.
+    keys: [
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      {
+        pubkey: params.controllingAuthority,
+        isSigner: true,
+        isWritable: false
+      },
+      { pubkey: params.secondarySigner, isSigner: true, isWritable: false },
+      { pubkey: params.treasuryPda, isSigner: false, isWritable: true },
+      { pubkey: params.policyPda, isSigner: false, isWritable: false },
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: false },
+      { pubkey: params.destination, isSigner: false, isWritable: true },
+      { pubkey: protocolFeePda, isSigner: false, isWritable: true }
+    ],
+    data
+  });
+  return { instruction };
+}
+function buildCommitDailyAnchorInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  if (params.merkleRoot.length !== 32) {
+    throw new RangeError(
+      `merkleRoot must be 32 bytes, got ${params.merkleRoot.length}`
+    );
+  }
+  const { pda: dailyAnchorPda } = deriveDailyAnchorPda(
+    params.deploymentPda,
+    params.dayUnix,
+    programId
+  );
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.commitDailyAnchor,
+    encodeI64(params.dayUnix),
+    Buffer.from(params.merkleRoot),
+    u32LeBytes(params.taskCount)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    // Order: deployment, company, anchor_signer, operations, daily_anchor,
+    // payer, system_program.
+    keys: [
+      { pubkey: params.deploymentPda, isSigner: false, isWritable: false },
+      { pubkey: params.companyPda, isSigner: false, isWritable: false },
+      { pubkey: params.anchorSigner, isSigner: true, isWritable: false },
+      { pubkey: params.operationsPda, isSigner: false, isWritable: false },
+      { pubkey: dailyAnchorPda, isSigner: false, isWritable: true },
+      { pubkey: params.payer, isSigner: true, isWritable: true },
+      { pubkey: import_web33.SystemProgram.programId, isSigner: false, isWritable: false }
+    ],
+    data
+  });
+  return { instruction };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ACCOUNT_DISCRIMINATOR,
+  AGENT_IDENTITY_SEED,
+  COMPANY_SEED,
+  COMPANY_STATUS,
+  DAILY_ANCHOR_SEED,
+  DEPLOYMENT_SEED,
+  DEPLOYMENT_STATUS,
+  INSTRUCTION_DISCRIMINATOR,
+  MAX_LOCALE_LEN,
+  MAX_METADATA_URI_LEN,
+  MAX_NAME_LEN,
+  MAX_REPUTATION_URI_LEN,
+  MAX_ROLE_LEN,
+  OPERATIONS_KIND,
+  OPERATIONS_SEED,
+  POLICY_SEED,
+  PROTOCOL_FEES_SEED,
+  REGISTRY_PROGRAM_ID,
+  REGISTRY_PROGRAM_ID_BASE58,
+  SOL_PSEUDO_MINT,
+  TREASURY_ACCOUNT_DISCRIMINATOR,
+  TREASURY_INSTRUCTION_DISCRIMINATOR,
+  TREASURY_PROGRAM_ID,
+  TREASURY_PROGRAM_ID_BASE58,
+  TREASURY_SEED,
+  buildCloseOperationsInstruction,
+  buildCommitDailyAnchorInstruction,
+  buildCreateCompanyInstruction,
+  buildCreateDeploymentInstruction,
+  buildDisburseDiscretionaryInstruction,
+  buildDisbursePrivilegedInstruction,
+  buildDisburseRoutineInstruction,
+  buildInitProtocolFeeAccountInstruction,
+  buildRegisterAgentIdentityInstruction,
+  buildRegisterCompanyOperationsInstruction,
+  buildRetireDeploymentInstruction,
+  buildRevokeOperationsInstruction,
+  buildSetPolicyInstruction,
+  buildSetReceivingAddressInstruction,
+  buildUpdateAgentIdentityMetadataInstruction,
+  buildUpdateCompanyMetadataInstruction,
+  buildUpdateCompanyStatusInstruction,
+  buildUpdateDeploymentMetadataInstruction,
+  buildUpdateDeploymentStatusInstruction,
+  buildUpdateOperationsCapabilityInstruction,
+  deriveAgentIdentityPda,
+  deriveCompanyPda,
+  deriveDailyAnchorPda,
+  deriveDeploymentPda,
+  deriveOperationsPda,
+  derivePolicyPda,
+  deriveProtocolFeePda,
+  deriveTreasuryPda,
+  u32LeBytes
+});
+//# sourceMappingURL=index.cjs.map