@perkos/agent-sdk 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to `@perkos/agent-sdk` are documented here.
 
 ## Unreleased
 
+## 0.6.0 - 2026-08-31
+
+### Changed
+
+- Promote the source-verified active defaults on both networks to `agentic-commerce-v4`,
+  `sbtc-commerce-v3` and `reputation-registry-v3`.
+- Pin the current official PoX-5 testnet sBTC principal
+  `SN3VMHXEN64ZZF71JQ5VESXDWTR301XTTXGF4J8F1.sbtc-token` in both escrow configuration and the
+  direct x402 asset registry; mainnet remains canonical `SM3VD...sbtc-token`.
+- Update onboarding and architecture documentation so normal v4/v3/v3 use no longer requires
+  explicit overrides. Historical same-network deployments remain configurable.
+
+### Evidence
+
+- Record the mainnet deploy/configuration confirmation in blocks 8885885–8885898 from exact
+  contracts/Web merge `670d23abe78051cfb3963228650fed5089d6827c`.
+- Record the guarded internal mainnet sBTC lifecycle from exact merge
+  `8782e547343deccf7477bc9c293987a3757d6d30`: PASS 26/26 for job `u1`, terminal `u3`, escrow
+  zero, exact 100-atomic-unit payout, successful reputation synchronization and persisted rating.
+- Keep team-operated release evidence explicitly separate from external adoption, non-team wallet
+  usage and revenue.
+
+### Security
+
+- Continue reading the live escrow and per-job pinned sBTC token before every versioned settlement;
+  exact deny-mode post-conditions remain mandatory.
+- Mainnet hosted x402/MPP settlement and npm publication remain separate release gates. The
+  independent external security review remains open.
+
 ## 0.5.1 - 2026-08-30
 
 ### Fixed

package/README.md

@@ -9,11 +9,11 @@ This repository is the continuation of `PerkOS-xyz/PerkOS-Agent-SDK`, renamed to
 public SDK with the Nayori product identity. The npm package remains `@perkos/agent-sdk` and the
 complete Git history, releases, issues, and pull requests are preserved.
 
-> Status: 0.5.1 developer release. Read clients, transaction builders, browser and headless signer
+> Status: 0.6.0 release candidate. Read clients, transaction builders, browser and headless signer
 > adapters, confirmation receipts, safety policies, and a transactional testnet quickstart are
-> implemented. The x402 v2 client and Stacks facilitator foundations are implemented; this release
-> adds wallet-linked OAuth and MCP support for the planned invite-only testnet pilot. Hosted rollout,
-> external review and adoption evidence remain before Milestone 2 completion. The direct x402
+> implemented. The x402 v2 client and Stacks facilitator foundations are implemented, with
+> wallet-linked OAuth and MCP support for the invite-only testnet pilot. The hosted testnet rollout
+> is live; external review and independently attributable adoption evidence remain open. The direct x402
 > profile includes request-bound pure verification
 > and payer-side intent, policy, Leather, and remote-signer foundations for STX, sBTC, and USDCx.
 > The SDK also implements the MPP PaymentAuth `usdc`/`charge` Stacks profile for direct USDCx,
@@ -52,8 +52,8 @@ the official v2 `PAYMENT-REQUIRED` header for an existing PerkOS escrow job:
 npm run quickstart:x402
 ```
 
-The facilitator example uses public Hiro v3 transaction and event data to inspect the historical
-M1 mainnet funding transaction. It proves the verifier fails closed when that otherwise matching
+The facilitator example uses public Hiro v3 transaction and event data to inspect a historical
+mainnet funding transaction. It proves the verifier fails closed when that otherwise matching
 proof is outside its payment window; it does not write replay state or submit a transaction:
 
 ```bash
@@ -138,23 +138,16 @@ Settlement helpers read the job and escrow balance before building exact contrac
 post-conditions. This protects both wallet-originated and headless transactions from transferring
 more than the job requires.
 
-## Versioned escrow candidate
+## Active versioned escrow
 
-The SDK can target the versioned contract interfaces introduced for Nayori's pre-launch security
-review, but the published mainnet and testnet defaults remain on the currently verified contracts.
-Do not override them until the chosen network has source-verified candidate deployments.
+Version `0.6.0` selects Nayori's source-verified v4/v3/v3 generation by default on mainnet and
+testnet. A normal client therefore needs no contract override:
 
 ```ts
-import { PerkOSClient, type ContractId } from "@perkos/agent-sdk";
+import { PerkOSClient } from "@perkos/agent-sdk";
 
-const deployer = "ST16EWRC01S1SFWGBP63MW47VY8P3AYFA8VGEBGE5";
 const perkos = new PerkOSClient({
-  network: "testnet",
-  contracts: {
-    stxCommerce: `${deployer}.agentic-commerce-v4` as ContractId,
-    sbtcCommerce: `${deployer}.sbtc-commerce-v3` as ContractId,
-    reputationRegistry: `${deployer}.reputation-registry-v3` as ContractId,
-  },
+  network: "mainnet",
   signer,
 });
 
@@ -169,7 +162,7 @@ const sync = await perkos.getReputationSync("sbtc", 7n);
 if (sync?.pending) await perkos.retryReputationSync("sbtc", 7n);
 ```
 
-The candidate's fixed 12-burn-block review window is readable through `getReviewWindow(asset)`.
+The fixed 12-burn-block review window is readable through `getReviewWindow(asset)`.
 Evaluator completion/rejection is available through the exact deadline; timeout settlement is
 available only after it. Timeout payout is returned as the distinct `timeout-paid` (`u6`) status
 and must not be counted as a completed job or reputation success. A failed reputation write never
@@ -180,17 +173,22 @@ pinned when the job was funded. Both the trait argument and exact fungible-token
 that historical token, so rotating the contract's future funding default cannot strand an existing
 escrow.
 
-The previous v3/v2 testnet generation remains supported and immutable at 144 blocks. The v4/v3
-overrides above are deployed and source-verified only on Stacks testnet from contracts/Web merge
-`b15544d601bd4e49610be854f7ad33a0af90c0a7`. Controlled STX and official PoX-5 sBTC complete paths
-pass 27/27 and 30/30. The real timeout path passes preparation 20/20, settlement 12/12 and
+The previous v3/v2 testnet generation remains supported through explicit overrides and immutable
+at 144 blocks. The active v4/v3/v3 generation first passed on Stacks testnet. Controlled STX and
+official PoX-5 sBTC complete paths pass 27/27 and 30/30. The real timeout path passes preparation
+20/20, settlement 12/12 and
 separate public-state verification 10/10. Job `u2` settled at burn `11290` in
 [`0x06537111…15bb9`](https://explorer.hiro.so/txid/0x06537111ef6c75d3c5d750154f97a3b4a0c233a84639583f7af18b2386915bb9?chain=testnet),
 ending in `timeout-paid` (`u6`) with zero escrow, one exact 1,000-atomic-unit sBTC payout and no
 completion, reputation or rating credit. The frozen evidence is documented in the
 [contracts/Web repository](https://github.com/PerkOS-xyz/PerkOS-Nayori/blob/main/docs/TESTNET_SECURITY_EVIDENCE.md).
-Keep the explicit overrides above: published package defaults remain unchanged until the external
-review and release gate close.
+
+The same exact sources are live on mainnet under
+`SP2K7PV5NXBNRV510S6DCA6RFMTFHAF3ZPK6ZSXPH`. Deploy/configuration confirmed in blocks
+8885885–8885898. A guarded internal mainnet sBTC job then passed 26/26 checks for exactly 100
+atomic units, ending in `completed` (`u3`) with escrow zero, exact payout, synchronized reputation
+and persisted rating. Those actors are team-operated release evidence, not external adoption,
+non-team wallet activity or revenue. The independent external security review remains open.
 
 ## Browser signer (Leather and other Stacks wallets)
 
@@ -520,8 +518,8 @@ or facilitator-submitted signed transaction.
 - Set a budget and fund escrow.
 - Assign a provider and submit a deliverable.
 - Complete, reject, or expire a job.
-- Settle an overdue candidate review to the provider with exact post-conditions.
-- Read and retry durable candidate reputation synchronization.
+- Settle an overdue review to the provider with exact post-conditions.
+- Read and retry durable reputation synchronization.
 - Rate a provider and read reputation.
 
 ## Security model
@@ -545,8 +543,8 @@ or facilitator-submitted signed transaction.
 - OAuth client secrets and access tokens are application secrets. The SDK returns them to the
   caller but does not persist, log or refresh them automatically.
 
-This package has not yet completed the external security review required for PerkOS Milestone 2.
-Do not treat the developer release as audited software.
+The independent external security review remains open. Do not treat this release candidate as
+audited software.
 
 See [Architecture](docs/ARCHITECTURE.md), [x402 payments](docs/X402_PAYMENTS.md),
 [MPP payments](docs/MPP_PAYMENTS.md), [Partner pilot](docs/PARTNER_PILOT.md) and

package/dist/constants.js

@@ -3,18 +3,18 @@ const TESTNET_DEPLOYER = "ST16EWRC01S1SFWGBP63MW47VY8P3AYFA8VGEBGE5";
 export const DEFAULT_DEPLOYMENTS = {
     mainnet: {
         agentRegistry: `${MAINNET_DEPLOYER}.agent-registry`,
-        stxCommerce: `${MAINNET_DEPLOYER}.agentic-commerce-v2`,
-        sbtcCommerce: `${MAINNET_DEPLOYER}.sbtc-commerce`,
-        reputationRegistry: `${MAINNET_DEPLOYER}.reputation-registry-v2`,
+        stxCommerce: `${MAINNET_DEPLOYER}.agentic-commerce-v4`,
+        sbtcCommerce: `${MAINNET_DEPLOYER}.sbtc-commerce-v3`,
+        reputationRegistry: `${MAINNET_DEPLOYER}.reputation-registry-v3`,
         sbtcToken: "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token",
         sbtcAssetName: "sbtc-token",
     },
     testnet: {
         agentRegistry: `${TESTNET_DEPLOYER}.agent-registry`,
-        stxCommerce: `${TESTNET_DEPLOYER}.agentic-commerce-v2`,
-        sbtcCommerce: `${TESTNET_DEPLOYER}.sbtc-commerce`,
-        reputationRegistry: `${TESTNET_DEPLOYER}.reputation-registry-v2`,
-        sbtcToken: "ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-token",
+        stxCommerce: `${TESTNET_DEPLOYER}.agentic-commerce-v4`,
+        sbtcCommerce: `${TESTNET_DEPLOYER}.sbtc-commerce-v3`,
+        reputationRegistry: `${TESTNET_DEPLOYER}.reputation-registry-v3`,
+        sbtcToken: "SN3VMHXEN64ZZF71JQ5VESXDWTR301XTTXGF4J8F1.sbtc-token",
         sbtcAssetName: "sbtc-token",
     },
 };

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/x402-direct.js

@@ -20,7 +20,7 @@ const SHA256_PATTERN = /^[0-9a-f]{64}$/;
 const METHOD_PATTERN = /^[A-Z][A-Z0-9!#$%&'*+.^_`|~-]{0,31}$/;
 const BASE64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
 const MAINNET_SBTC = "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token";
-const TESTNET_SBTC = "ST1F7QA2MDF17S807EPA36TSS8AMEFY4KA9TVGWXT.sbtc-token";
+const TESTNET_SBTC = "SN3VMHXEN64ZZF71JQ5VESXDWTR301XTTXGF4J8F1.sbtc-token";
 const MAINNET_USDCX = "SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx";
 const TESTNET_USDCX = "ST2WK9SGBJ15RHZ33KK0KYVSXBEBHM1XDM8C96EC4.usdcx";
 function stxAsset(network) {

package/docs/ARCHITECTURE.md

@@ -149,15 +149,15 @@ and `sbtc-commerce-v3`, the client also reads the job-pinned token and uses it i
 fungible-token post-condition; a later default-token rotation cannot redirect or strand an
 existing escrow.
 
-The current v4/v3 candidate records a fixed 12 Bitcoin burn-block review deadline at submission.
+The active v4/v3 generation records a fixed 12 Bitcoin burn-block review deadline at submission.
 The immutable earlier v3/v2 testnet generation remains supported at 144 blocks. Through the
 deadline, the evaluator remains the only completion/rejection authority. After it, any principal
 may submit `settle-review-timeout`; the SDK treats the result as `timeout-paid`, not completion.
 Reputation synchronization has its own durable read record and deny-mode retry plan so registry
 unavailability never expands payment authority or rolls back the payout.
 
-Versioned contract IDs are explicit configuration overrides. Default deployments do not change
-until a public-network candidate has source verification and release approval.
+Versioned v4/v3/v3 contract IDs are the defaults on both networks. Historical generations remain
+available through explicit same-network overrides.
 
 ## Future adapters
 

package/docs/MPP_PAYMENTS.md

@@ -16,7 +16,7 @@ Official references:
 - [OpenAPI payment discovery](https://github.com/tempoxyz/mpp-specs/blob/main/specs/extensions/draft-payment-discovery-01.md)
 - [Circle xReserve live domain registry](https://xreserve-api-testnet.circle.com/v1/info)
 
-For testnet, SDK 0.5.1 pins the token currently registered by Circle xReserve remote domain
+For testnet, SDK 0.5.1 and later pin the token currently registered by Circle xReserve remote domain
 `10003`: `ST2WK9SGBJ15RHZ33KK0KYVSXBEBHM1XDM8C96EC4.usdcx`. The live registry and a successful
 official bridge mint are authoritative when older static documentation differs. The mainnet token
 identity is unchanged.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perkos/agent-sdk",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "TypeScript SDK for agent identity, escrow settlement, and reputation on Stacks.",
   "type": "module",
   "main": "./dist/index.js",