@agent-fuel/sdk 0.1.0 → 0.1.1

package/dist/index.cjs

@@ -187,6 +187,28 @@ var NotWhitelistedError = class extends SpendPolicyError {
     this.service = service;
   }
 };
+var RecordPaymentError = class extends AgentFuelError {
+  constructor(message) {
+    super(message);
+    this.name = "RecordPaymentError";
+  }
+};
+var ReceiptAlreadyRecordedError = class extends RecordPaymentError {
+  receiptHash;
+  constructor(receiptHash) {
+    super("payment receipt was already recorded on chain");
+    this.name = "ReceiptAlreadyRecordedError";
+    this.receiptHash = receiptHash;
+  }
+};
+var ServiceInactiveError = class extends RecordPaymentError {
+  service;
+  constructor(service) {
+    super(`service ${service} is paused; record_payment rejected`);
+    this.name = "ServiceInactiveError";
+    this.service = service;
+  }
+};
 
 // src/guardrails.ts
 function guardSpend(args) {
@@ -294,6 +316,12 @@ function wsUrl(apiBase, path) {
   if (apiBase.startsWith("http://")) return apiBase.replace(/^http/, "ws") + path;
   return apiBase + path;
 }
+function subscribeService(apiBase, servicePubkey, opts) {
+  return subscribe(wsUrl(apiBase, `/ws/services/${servicePubkey}`), opts);
+}
+function subscribeVault(apiBase, vaultPubkey, opts) {
+  return subscribe(wsUrl(apiBase, `/ws/vaults/${vaultPubkey}`), opts);
+}
 
 // src/idl/reputation.json
 var reputation_default = {
@@ -849,10 +877,14 @@ var reputation_default = {
       ],
       accounts: [
         {
-          name: "service",
+          name: "sponsor",
           writable: true,
           signer: true
         },
+        {
+          name: "service",
+          signer: true
+        },
         {
           name: "service_registry",
           writable: true,
@@ -899,6 +931,15 @@ var reputation_default = {
               name: "ServiceCategory"
             }
           }
+        },
+        {
+          name: "service_uri",
+          type: {
+            array: [
+              "u8",
+              128
+            ]
+          }
         }
       ]
     },
@@ -1014,6 +1055,61 @@ var reputation_default = {
           }
         }
       ]
+    },
+    {
+      name: "set_service_active",
+      discriminator: [
+        221,
+        172,
+        149,
+        49,
+        212,
+        184,
+        77,
+        101
+      ],
+      accounts: [
+        {
+          name: "service",
+          signer: true
+        },
+        {
+          name: "service_registry",
+          writable: true,
+          pda: {
+            seeds: [
+              {
+                kind: "const",
+                value: [
+                  115,
+                  101,
+                  114,
+                  118,
+                  105,
+                  99,
+                  101
+                ]
+              },
+              {
+                kind: "account",
+                path: "service"
+              }
+            ]
+          }
+        },
+        {
+          name: "authority",
+          relations: [
+            "service_registry"
+          ]
+        }
+      ],
+      args: [
+        {
+          name: "active",
+          type: "bool"
+        }
+      ]
     }
   ],
   accounts: [
@@ -1162,6 +1258,19 @@ var reputation_default = {
         109
       ]
     },
+    {
+      name: "ServiceActiveSet",
+      discriminator: [
+        151,
+        122,
+        7,
+        40,
+        191,
+        139,
+        237,
+        52
+      ]
+    },
     {
       name: "ServiceRegistered",
       discriminator: [
@@ -1226,6 +1335,11 @@ var reputation_default = {
       code: 6009,
       name: "FeedbackRateLimited",
       msg: "Feedback rate limit not yet expired for this (service, agent) pair"
+    },
+    {
+      code: 6010,
+      name: "UnauthorizedService",
+      msg: "Only the service authority may perform this action"
     }
   ],
   types: [
@@ -1666,6 +1780,26 @@ var reputation_default = {
         ]
       }
     },
+    {
+      name: "ServiceActiveSet",
+      type: {
+        kind: "struct",
+        fields: [
+          {
+            name: "service",
+            type: "pubkey"
+          },
+          {
+            name: "active",
+            type: "bool"
+          },
+          {
+            name: "slot",
+            type: "u64"
+          }
+        ]
+      }
+    },
     {
       name: "ServiceCategory",
       type: {
@@ -1698,6 +1832,14 @@ var reputation_default = {
             name: "service",
             type: "pubkey"
           },
+          {
+            name: "sponsor",
+            docs: [
+              'Wallet that paid rent. Lets us answer "who registered this service?"',
+              "without an extra column on the on-chain account."
+            ],
+            type: "pubkey"
+          },
           {
             name: "name",
             type: {
@@ -1740,6 +1882,19 @@ var reputation_default = {
               ]
             }
           },
+          {
+            name: "service_uri",
+            docs: [
+              "Off-chain metadata URI (pricing, docs, endpoint, logo). Padded to 128 bytes;",
+              "trailing NULs are trimmed when read. Mirrors `AgentProfile::agent_uri`."
+            ],
+            type: {
+              array: [
+                "u8",
+                128
+              ]
+            }
+          },
           {
             name: "category",
             type: {
@@ -3096,6 +3251,34 @@ function serviceRegistryPda(serviceAuthority) {
   );
   return pda;
 }
+function agentProfilePda(agent) {
+  const [pda] = web3_js.PublicKey.findProgramAddressSync(
+    [Buffer.from("agent"), toPubkey(agent).toBuffer()],
+    PROGRAM_IDS.reputation
+  );
+  return pda;
+}
+function agentServiceLinkPda(agentProfile, serviceRegistry) {
+  const [pda] = web3_js.PublicKey.findProgramAddressSync(
+    [
+      Buffer.from("link"),
+      toPubkey(agentProfile).toBuffer(),
+      toPubkey(serviceRegistry).toBuffer()
+    ],
+    PROGRAM_IDS.reputation
+  );
+  return pda;
+}
+function receiptUsedPda(receiptHash) {
+  if (receiptHash.length !== 32) {
+    throw new Error(`receiptUsedPda expects a 32-byte hash, got ${receiptHash.length}`);
+  }
+  const [pda] = web3_js.PublicKey.findProgramAddressSync(
+    [Buffer.from("receipt"), Buffer.from(receiptHash)],
+    PROGRAM_IDS.reputation
+  );
+  return pda;
+}
 function buildProvider(connection, keypair) {
   return new anchor.AnchorProvider(connection, new anchor.Wallet(keypair), anchor.AnchorProvider.defaultOptions());
 }
@@ -3204,6 +3387,21 @@ var AgentFuel = class {
       throw mapSpendError(err, { service, amountUsdc, vault, policy });
     }
   }
+  /// Triggers an on-chain recomputation of the agent's reputation score.
+  /// Permissionless — any signer can call it; we use the agent itself since
+  /// the SDK already has its keypair available and it already pays tx fees
+  /// for spends. The instruction reads the agent's already-public counters
+  /// (volume, diversity, streak, tenure, feedback), recalculates the score
+  /// to a single u16 ≤ 1000, and emits a `ScoreComputed` event. The webhook
+  /// picks that up; the next `getScore()` returns the fresh value.
+  async computeScore() {
+    const profile = agentProfilePda(this.agentPubkey);
+    const signature = await this.reputation.methods.computeScore().accounts({
+      caller: this.agentPubkey,
+      agentProfile: profile
+    }).signers([this.agent]).rpc();
+    return { signature };
+  }
   onEvent(callback, options) {
     const target = options?.agent ? toPubkey(options.agent) : this.agentPubkey;
     const url = wsUrl(this.apiBase, `/ws/agents/${target.toBase58()}`);
@@ -3248,6 +3446,56 @@ async function safeText(res) {
     return void 0;
   }
 }
+async function recordPayment(args) {
+  const { service, connection, amountUsdc } = args;
+  const agentPubkey = toPubkey(args.agent);
+  if (amountUsdc <= 0) {
+    throw new Error("recordPayment: amountUsdc must be > 0");
+  }
+  if (args.receiptHash.length !== 32) {
+    throw new Error(
+      `recordPayment: receiptHash must be 32 bytes, got ${args.receiptHash.length}`
+    );
+  }
+  const provider = buildProvider(connection, service);
+  const program = reputationProgram(provider);
+  const agentProfile = agentProfilePda(agentPubkey);
+  const serviceRegistry = serviceRegistryPda(service.publicKey);
+  const link = agentServiceLinkPda(agentProfile, serviceRegistry);
+  const receipt = receiptUsedPda(args.receiptHash);
+  try {
+    const signature = await program.methods.recordPayment(new anchor.BN(amountUsdc), args.receiptHash).accounts({
+      service: service.publicKey,
+      agentProfile,
+      serviceRegistry,
+      agentServiceLink: link,
+      receiptUsed: receipt,
+      systemProgram: web3_js.SystemProgram.programId
+    }).signers([service]).rpc();
+    return { signature };
+  } catch (err) {
+    throw mapRecordPaymentError(err, args.receiptHash);
+  }
+}
+function mapRecordPaymentError(err, receiptHash) {
+  const message = err instanceof Error ? err.message : String(err);
+  if (/already in use/i.test(message)) {
+    return new ReceiptAlreadyRecordedError(receiptHash);
+  }
+  if (!(err instanceof anchor.AnchorError)) return err;
+  switch (err.error.errorCode.number) {
+    case 6e3:
+      return new RecordPaymentError("counter overflow on chain");
+    case 6001:
+      return new ServiceInactiveError(
+        err.error.origin?.toString() ?? "<unknown service>"
+      );
+    case 6002:
+      return new ZeroAmountError();
+    default:
+      return err;
+  }
+}
 
 // src/x402.ts
 var HEADER = "X-Payment-Required";
@@ -3346,16 +3594,25 @@ exports.OwnerNotConfiguredError = OwnerNotConfiguredError;
 exports.PROGRAM_IDS = PROGRAM_IDS;
 exports.PaymentParseError = PaymentParseError;
 exports.PerTxLimitExceededError = PerTxLimitExceededError;
+exports.ReceiptAlreadyRecordedError = ReceiptAlreadyRecordedError;
+exports.RecordPaymentError = RecordPaymentError;
 exports.SLOTS_PER_HOUR = SLOTS_PER_HOUR;
+exports.ServiceInactiveError = ServiceInactiveError;
 exports.SpendPolicyError = SpendPolicyError;
 exports.TOKEN_PROGRAM_ID = TOKEN_PROGRAM_ID;
 exports.VaultFrozenError = VaultFrozenError;
 exports.ZeroAmountError = ZeroAmountError;
+exports.agentProfilePda = agentProfilePda;
+exports.agentServiceLinkPda = agentServiceLinkPda;
 exports.createAssociatedTokenAccountIdempotentInstruction = createAssociatedTokenAccountIdempotentInstruction;
 exports.getAssociatedTokenAddress = getAssociatedTokenAddress;
 exports.paymentRequired = paymentRequired;
 exports.policyPda = policyPda;
+exports.receiptUsedPda = receiptUsedPda;
+exports.recordPayment = recordPayment;
 exports.serviceRegistryPda = serviceRegistryPda;
+exports.subscribeService = subscribeService;
+exports.subscribeVault = subscribeVault;
 exports.vaultPda = vaultPda;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map