@occa/sdk 0.4.0 → 0.5.0

package/dist/constants.d.ts

@@ -12,10 +12,14 @@ declare const POLICY_SEED: Buffer<ArrayBuffer>;
 declare const PROTOCOL_FEES_SEED: Buffer<ArrayBuffer>;
 declare const OPERATIONS_SEED: Buffer<ArrayBuffer>;
 declare const DAILY_ANCHOR_SEED: Buffer<ArrayBuffer>;
+declare const TRACE_SEED: Buffer<ArrayBuffer>;
 declare const OPERATIONS_KIND: {
     /** Disbursement Wallet — operator-held only, signs `disburse_routine`. */
     readonly Disbursement: 0;
-    /** Anchor Wallet — operator+OCCA shared, signs `commit_daily_anchor`. */
+    /**
+     * Anchor Wallet — operator+OCCA shared, signs `commit_daily_anchor`
+     * and `commit_trace`.
+     */
     readonly Anchor: 1;
 };
 type OperationsKind = (typeof OPERATIONS_KIND)[keyof typeof OPERATIONS_KIND];
@@ -25,6 +29,12 @@ declare const MAX_LOCALE_LEN = 8;
 declare const MAX_ROLE_LEN = 32;
 declare const MAX_METADATA_URI_LEN = 200;
 declare const MAX_REPUTATION_URI_LEN = 200;
+declare const MAX_RESULT_URI_LEN = 200;
+declare const MAX_QUALITY_SCORE = 100;
+declare const TRACE_VERDICT: {
+    readonly Passed: 1;
+};
+type TraceVerdict = (typeof TRACE_VERDICT)[keyof typeof TRACE_VERDICT];
 declare const COMPANY_STATUS: {
     readonly Active: 0;
     readonly Paused: 1;
@@ -42,6 +52,7 @@ declare const ACCOUNT_DISCRIMINATOR: {
     readonly CompanyAccount: Buffer<ArrayBuffer>;
     readonly Deployment: Buffer<ArrayBuffer>;
     readonly DailyAnchorAccount: Buffer<ArrayBuffer>;
+    readonly TraceAnchorAccount: Buffer<ArrayBuffer>;
 };
 declare const TREASURY_ACCOUNT_DISCRIMINATOR: {
     readonly TreasuryAccount: Buffer<ArrayBuffer>;
@@ -50,4 +61,4 @@ declare const TREASURY_ACCOUNT_DISCRIMINATOR: {
     readonly OperationsAccount: Buffer<ArrayBuffer>;
 };
 
-export { ACCOUNT_DISCRIMINATOR, AGENT_IDENTITY_SEED, COMPANY_SEED, COMPANY_STATUS, type CompanyStatus, DAILY_ANCHOR_SEED, DEPLOYMENT_SEED, DEPLOYMENT_STATUS, type DeploymentStatus, MAX_LOCALE_LEN, MAX_METADATA_URI_LEN, MAX_NAME_LEN, MAX_REPUTATION_URI_LEN, MAX_ROLE_LEN, OPERATIONS_KIND, OPERATIONS_SEED, type OperationsKind, POLICY_SEED, PROTOCOL_FEES_SEED, REGISTRY_PROGRAM_ID, REGISTRY_PROGRAM_ID_BASE58, SOL_PSEUDO_MINT, TREASURY_ACCOUNT_DISCRIMINATOR, TREASURY_PROGRAM_ID, TREASURY_PROGRAM_ID_BASE58, TREASURY_SEED };
+export { ACCOUNT_DISCRIMINATOR, AGENT_IDENTITY_SEED, COMPANY_SEED, COMPANY_STATUS, type CompanyStatus, DAILY_ANCHOR_SEED, DEPLOYMENT_SEED, DEPLOYMENT_STATUS, type DeploymentStatus, MAX_LOCALE_LEN, MAX_METADATA_URI_LEN, MAX_NAME_LEN, MAX_QUALITY_SCORE, MAX_REPUTATION_URI_LEN, MAX_RESULT_URI_LEN, MAX_ROLE_LEN, OPERATIONS_KIND, OPERATIONS_SEED, type OperationsKind, POLICY_SEED, PROTOCOL_FEES_SEED, REGISTRY_PROGRAM_ID, REGISTRY_PROGRAM_ID_BASE58, SOL_PSEUDO_MINT, TRACE_SEED, TRACE_VERDICT, TREASURY_ACCOUNT_DISCRIMINATOR, TREASURY_PROGRAM_ID, TREASURY_PROGRAM_ID_BASE58, TREASURY_SEED, type TraceVerdict };

package/dist/constants.js

@@ -9,7 +9,9 @@ import {
   MAX_LOCALE_LEN,
   MAX_METADATA_URI_LEN,
   MAX_NAME_LEN,
+  MAX_QUALITY_SCORE,
   MAX_REPUTATION_URI_LEN,
+  MAX_RESULT_URI_LEN,
   MAX_ROLE_LEN,
   OPERATIONS_KIND,
   OPERATIONS_SEED,
@@ -18,11 +20,13 @@ import {
   REGISTRY_PROGRAM_ID,
   REGISTRY_PROGRAM_ID_BASE58,
   SOL_PSEUDO_MINT,
+  TRACE_SEED,
+  TRACE_VERDICT,
   TREASURY_ACCOUNT_DISCRIMINATOR,
   TREASURY_PROGRAM_ID,
   TREASURY_PROGRAM_ID_BASE58,
   TREASURY_SEED
-} from "./chunk-YCSBYRSH.js";
+} from "./chunk-BR62YC5F.js";
 export {
   ACCOUNT_DISCRIMINATOR,
   AGENT_IDENTITY_SEED,
@@ -34,7 +38,9 @@ export {
   MAX_LOCALE_LEN,
   MAX_METADATA_URI_LEN,
   MAX_NAME_LEN,
+  MAX_QUALITY_SCORE,
   MAX_REPUTATION_URI_LEN,
+  MAX_RESULT_URI_LEN,
   MAX_ROLE_LEN,
   OPERATIONS_KIND,
   OPERATIONS_SEED,
@@ -43,6 +49,8 @@ export {
   REGISTRY_PROGRAM_ID,
   REGISTRY_PROGRAM_ID_BASE58,
   SOL_PSEUDO_MINT,
+  TRACE_SEED,
+  TRACE_VERDICT,
   TREASURY_ACCOUNT_DISCRIMINATOR,
   TREASURY_PROGRAM_ID,
   TREASURY_PROGRAM_ID_BASE58,

package/dist/index.cjs

@@ -31,7 +31,9 @@ __export(src_exports, {
   MAX_LOCALE_LEN: () => MAX_LOCALE_LEN,
   MAX_METADATA_URI_LEN: () => MAX_METADATA_URI_LEN,
   MAX_NAME_LEN: () => MAX_NAME_LEN,
+  MAX_QUALITY_SCORE: () => MAX_QUALITY_SCORE,
   MAX_REPUTATION_URI_LEN: () => MAX_REPUTATION_URI_LEN,
+  MAX_RESULT_URI_LEN: () => MAX_RESULT_URI_LEN,
   MAX_ROLE_LEN: () => MAX_ROLE_LEN,
   OPERATIONS_KIND: () => OPERATIONS_KIND,
   OPERATIONS_SEED: () => OPERATIONS_SEED,
@@ -40,6 +42,8 @@ __export(src_exports, {
   REGISTRY_PROGRAM_ID: () => REGISTRY_PROGRAM_ID,
   REGISTRY_PROGRAM_ID_BASE58: () => REGISTRY_PROGRAM_ID_BASE58,
   SOL_PSEUDO_MINT: () => SOL_PSEUDO_MINT,
+  TRACE_SEED: () => TRACE_SEED,
+  TRACE_VERDICT: () => TRACE_VERDICT,
   TREASURY_ACCOUNT_DISCRIMINATOR: () => TREASURY_ACCOUNT_DISCRIMINATOR,
   TREASURY_INSTRUCTION_DISCRIMINATOR: () => TREASURY_INSTRUCTION_DISCRIMINATOR,
   TREASURY_PROGRAM_ID: () => TREASURY_PROGRAM_ID,
@@ -47,6 +51,7 @@ __export(src_exports, {
   TREASURY_SEED: () => TREASURY_SEED,
   buildCloseOperationsInstruction: () => buildCloseOperationsInstruction,
   buildCommitDailyAnchorInstruction: () => buildCommitDailyAnchorInstruction,
+  buildCommitTraceInstruction: () => buildCommitTraceInstruction,
   buildCreateCompanyInstruction: () => buildCreateCompanyInstruction,
   buildCreateDeploymentInstruction: () => buildCreateDeploymentInstruction,
   buildDisburseDiscretionaryInstruction: () => buildDisburseDiscretionaryInstruction,
@@ -57,6 +62,7 @@ __export(src_exports, {
   buildRegisterCompanyOperationsInstruction: () => buildRegisterCompanyOperationsInstruction,
   buildRetireDeploymentInstruction: () => buildRetireDeploymentInstruction,
   buildRevokeOperationsInstruction: () => buildRevokeOperationsInstruction,
+  buildSetAgentReceivingAddressInstruction: () => buildSetAgentReceivingAddressInstruction,
   buildSetPolicyInstruction: () => buildSetPolicyInstruction,
   buildSetReceivingAddressInstruction: () => buildSetReceivingAddressInstruction,
   buildUpdateAgentIdentityMetadataInstruction: () => buildUpdateAgentIdentityMetadataInstruction,
@@ -72,6 +78,7 @@ __export(src_exports, {
   deriveOperationsPda: () => deriveOperationsPda,
   derivePolicyPda: () => derivePolicyPda,
   deriveProtocolFeePda: () => deriveProtocolFeePda,
+  deriveTraceAnchorPda: () => deriveTraceAnchorPda,
   deriveTreasuryPda: () => deriveTreasuryPda,
   u32LeBytes: () => u32LeBytes
 });
@@ -91,10 +98,14 @@ 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 TRACE_SEED = Buffer.from("trace");
 var OPERATIONS_KIND = {
   /** Disbursement Wallet — operator-held only, signs `disburse_routine`. */
   Disbursement: 0,
-  /** Anchor Wallet — operator+OCCA shared, signs `commit_daily_anchor`. */
+  /**
+   * Anchor Wallet — operator+OCCA shared, signs `commit_daily_anchor`
+   * and `commit_trace`.
+   */
   Anchor: 1
 };
 var SOL_PSEUDO_MINT = new import_web3.PublicKey(new Uint8Array(32));
@@ -103,6 +114,11 @@ var MAX_LOCALE_LEN = 8;
 var MAX_ROLE_LEN = 32;
 var MAX_METADATA_URI_LEN = 200;
 var MAX_REPUTATION_URI_LEN = 200;
+var MAX_RESULT_URI_LEN = 200;
+var MAX_QUALITY_SCORE = 100;
+var TRACE_VERDICT = {
+  Passed: 1
+};
 var COMPANY_STATUS = {
   Active: 0,
   Paused: 1
@@ -117,7 +133,8 @@ 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])
+  DailyAnchorAccount: Buffer.from([218, 106, 107, 94, 194, 48, 111, 254]),
+  TraceAnchorAccount: Buffer.from([159, 101, 186, 98, 211, 217, 119, 232])
 };
 var TREASURY_ACCOUNT_DISCRIMINATOR = {
   TreasuryAccount: Buffer.from([204, 140, 18, 173, 90, 152, 134, 123]),
@@ -197,6 +214,16 @@ function deriveDailyAnchorPda(deploymentPda, dayUnix, programId = REGISTRY_PROGR
   );
   return { pda, bump };
 }
+function deriveTraceAnchorPda(taskId, programId = REGISTRY_PROGRAM_ID) {
+  if (taskId.length !== 32) {
+    throw new RangeError(`taskId must be 32 bytes, got ${taskId.length}`);
+  }
+  const [pda, bump] = import_web32.PublicKey.findProgramAddressSync(
+    [TRACE_SEED, Buffer.from(taskId)],
+    programId
+  );
+  return { pda, bump };
+}
 
 // src/instructions.ts
 var import_web33 = require("@solana/web3.js");
@@ -220,7 +247,9 @@ var INSTRUCTION_DISCRIMINATOR = {
   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])
+  setAgentReceivingAddress: Buffer.from([197, 126, 122, 18, 38, 62, 179, 218]),
+  commitDailyAnchor: Buffer.from([18, 7, 3, 65, 58, 148, 164, 0]),
+  commitTrace: Buffer.from([58, 140, 230, 51, 170, 109, 228, 125])
 };
 function encodeString(s) {
   const utf8 = Buffer.from(s, "utf8");
@@ -454,6 +483,22 @@ function buildSetReceivingAddressInstruction(params) {
   });
   return { instruction };
 }
+function buildSetAgentReceivingAddressInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.setAgentReceivingAddress,
+    encodePubkey(params.newReceivingAddress)
+  ]);
+  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 };
+}
 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]),
@@ -810,6 +855,60 @@ function buildCommitDailyAnchorInstruction(params) {
   });
   return { instruction };
 }
+function buildCommitTraceInstruction(params) {
+  const programId = params.programId ?? REGISTRY_PROGRAM_ID;
+  if (params.taskId.length !== 32) {
+    throw new RangeError(`taskId must be 32 bytes, got ${params.taskId.length}`);
+  }
+  if (params.contentHash.length !== 32) {
+    throw new RangeError(
+      `contentHash must be 32 bytes, got ${params.contentHash.length}`
+    );
+  }
+  if (params.evidenceHash.length !== 32) {
+    throw new RangeError(
+      `evidenceHash must be 32 bytes, got ${params.evidenceHash.length}`
+    );
+  }
+  if (Buffer.from(params.resultUri, "utf8").length > MAX_RESULT_URI_LEN) {
+    throw new RangeError(
+      `resultUri exceeds MAX_RESULT_URI_LEN (${MAX_RESULT_URI_LEN} bytes)`
+    );
+  }
+  if (params.qualityScore < 0 || params.qualityScore > MAX_QUALITY_SCORE) {
+    throw new RangeError(
+      `qualityScore out of range 0..=${MAX_QUALITY_SCORE}: ${params.qualityScore}`
+    );
+  }
+  const taskId = Buffer.from(params.taskId);
+  const { pda: traceAnchorPda } = deriveTraceAnchorPda(taskId, programId);
+  const data = Buffer.concat([
+    INSTRUCTION_DISCRIMINATOR.commitTrace,
+    taskId,
+    encodeString(params.resultUri),
+    Buffer.from(params.contentHash),
+    encodeU8(params.qualityScore),
+    encodeU8(params.rubricVersion),
+    Buffer.from(params.evidenceHash),
+    encodeI64(params.completedAt)
+  ]);
+  const instruction = new import_web33.TransactionInstruction({
+    programId,
+    // Order: deployment, company, anchor_signer, operations, trace_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: traceAnchorPda, isSigner: false, isWritable: true },
+      { pubkey: params.payer, isSigner: true, isWritable: true },
+      { pubkey: import_web33.SystemProgram.programId, isSigner: false, isWritable: false }
+    ],
+    data
+  });
+  return { instruction, traceAnchorPda };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ACCOUNT_DISCRIMINATOR,
@@ -823,7 +922,9 @@ function buildCommitDailyAnchorInstruction(params) {
   MAX_LOCALE_LEN,
   MAX_METADATA_URI_LEN,
   MAX_NAME_LEN,
+  MAX_QUALITY_SCORE,
   MAX_REPUTATION_URI_LEN,
+  MAX_RESULT_URI_LEN,
   MAX_ROLE_LEN,
   OPERATIONS_KIND,
   OPERATIONS_SEED,
@@ -832,6 +933,8 @@ function buildCommitDailyAnchorInstruction(params) {
   REGISTRY_PROGRAM_ID,
   REGISTRY_PROGRAM_ID_BASE58,
   SOL_PSEUDO_MINT,
+  TRACE_SEED,
+  TRACE_VERDICT,
   TREASURY_ACCOUNT_DISCRIMINATOR,
   TREASURY_INSTRUCTION_DISCRIMINATOR,
   TREASURY_PROGRAM_ID,
@@ -839,6 +942,7 @@ function buildCommitDailyAnchorInstruction(params) {
   TREASURY_SEED,
   buildCloseOperationsInstruction,
   buildCommitDailyAnchorInstruction,
+  buildCommitTraceInstruction,
   buildCreateCompanyInstruction,
   buildCreateDeploymentInstruction,
   buildDisburseDiscretionaryInstruction,
@@ -849,6 +953,7 @@ function buildCommitDailyAnchorInstruction(params) {
   buildRegisterCompanyOperationsInstruction,
   buildRetireDeploymentInstruction,
   buildRevokeOperationsInstruction,
+  buildSetAgentReceivingAddressInstruction,
   buildSetPolicyInstruction,
   buildSetReceivingAddressInstruction,
   buildUpdateAgentIdentityMetadataInstruction,
@@ -864,6 +969,7 @@ function buildCommitDailyAnchorInstruction(params) {
   deriveOperationsPda,
   derivePolicyPda,
   deriveProtocolFeePda,
+  deriveTraceAnchorPda,
   deriveTreasuryPda,
   u32LeBytes
 });