@perkos/agent-sdk 0.5.1 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +55 -0
- package/README.md +77 -30
- package/dist/builders.d.ts +7 -1
- package/dist/builders.d.ts.map +1 -1
- package/dist/builders.js +58 -1
- package/dist/builders.js.map +1 -1
- package/dist/clarity.d.ts +1 -0
- package/dist/clarity.d.ts.map +1 -1
- package/dist/clarity.js +6 -0
- package/dist/clarity.js.map +1 -1
- package/dist/client.d.ts +9 -1
- package/dist/client.d.ts.map +1 -1
- package/dist/client.js +115 -2
- package/dist/client.js.map +1 -1
- package/dist/constants.d.ts +2 -0
- package/dist/constants.d.ts.map +1 -1
- package/dist/constants.js +51 -7
- package/dist/constants.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +43 -2
- package/dist/types.d.ts.map +1 -1
- package/dist/validation.d.ts +2 -1
- package/dist/validation.d.ts.map +1 -1
- package/dist/validation.js +17 -0
- package/dist/validation.js.map +1 -1
- package/dist/x402-direct.js +1 -1
- package/docs/ARCHITECTURE.md +3 -3
- package/docs/MPP_PAYMENTS.md +1 -1
- package/docs/plans/2026-09-01-full-functional-docs-gate-design.md +22 -0
- package/examples/x402-facilitator.ts +5 -5
- package/package.json +1 -1
package/dist/validation.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"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"}
|
package/dist/x402-direct.js
CHANGED
|
@@ -20,7 +20,7 @@ const SHA256_PATTERN = /^[0-9a-f]{64}$/;
|
|
|
20
20
|
const METHOD_PATTERN = /^[A-Z][A-Z0-9!#$%&'*+.^_`|~-]{0,31}$/;
|
|
21
21
|
const BASE64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
|
|
22
22
|
const MAINNET_SBTC = "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token";
|
|
23
|
-
const TESTNET_SBTC = "
|
|
23
|
+
const TESTNET_SBTC = "SN3VMHXEN64ZZF71JQ5VESXDWTR301XTTXGF4J8F1.sbtc-token";
|
|
24
24
|
const MAINNET_USDCX = "SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx";
|
|
25
25
|
const TESTNET_USDCX = "ST2WK9SGBJ15RHZ33KK0KYVSXBEBHM1XDM8C96EC4.usdcx";
|
|
26
26
|
function stxAsset(network) {
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -149,15 +149,15 @@ and `sbtc-commerce-v3`, the client also reads the job-pinned token and uses it i
|
|
|
149
149
|
fungible-token post-condition; a later default-token rotation cannot redirect or strand an
|
|
150
150
|
existing escrow.
|
|
151
151
|
|
|
152
|
-
The
|
|
152
|
+
The active v4/v3 generation records a fixed 12 Bitcoin burn-block review deadline at submission.
|
|
153
153
|
The immutable earlier v3/v2 testnet generation remains supported at 144 blocks. Through the
|
|
154
154
|
deadline, the evaluator remains the only completion/rejection authority. After it, any principal
|
|
155
155
|
may submit `settle-review-timeout`; the SDK treats the result as `timeout-paid`, not completion.
|
|
156
156
|
Reputation synchronization has its own durable read record and deny-mode retry plan so registry
|
|
157
157
|
unavailability never expands payment authority or rolls back the payout.
|
|
158
158
|
|
|
159
|
-
Versioned contract IDs are
|
|
160
|
-
|
|
159
|
+
Versioned v4/v3/v3 contract IDs are the defaults on both networks. Historical generations remain
|
|
160
|
+
available through explicit same-network overrides.
|
|
161
161
|
|
|
162
162
|
## Future adapters
|
|
163
163
|
|
package/docs/MPP_PAYMENTS.md
CHANGED
|
@@ -16,7 +16,7 @@ Official references:
|
|
|
16
16
|
- [OpenAPI payment discovery](https://github.com/tempoxyz/mpp-specs/blob/main/specs/extensions/draft-payment-discovery-01.md)
|
|
17
17
|
- [Circle xReserve live domain registry](https://xreserve-api-testnet.circle.com/v1/info)
|
|
18
18
|
|
|
19
|
-
For testnet, SDK 0.5.1
|
|
19
|
+
For testnet, SDK 0.5.1 and later pin the token currently registered by Circle xReserve remote domain
|
|
20
20
|
`10003`: `ST2WK9SGBJ15RHZ33KK0KYVSXBEBHM1XDM8C96EC4.usdcx`. The live registry and a successful
|
|
21
21
|
official bridge mint are authoritative when older static documentation differs. The mainnet token
|
|
22
22
|
identity is unchanged.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Full-functional SDK and documentation gate
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
Make the public Nayori onboarding path reproducible before inviting developers, without treating
|
|
6
|
+
external adoption, external transactions, or an external contract audit as part of this internal
|
|
7
|
+
technical gate.
|
|
8
|
+
|
|
9
|
+
## Acceptance criteria
|
|
10
|
+
|
|
11
|
+
- The npm package remains installable from the public registry.
|
|
12
|
+
- Every signer-free quickstart exits successfully without requesting a wallet or broadcasting.
|
|
13
|
+
- The facilitator example uses immutable public mainnet evidence that matches the active contract,
|
|
14
|
+
asset, amount, payer, job and block metadata before demonstrating fail-closed expiry.
|
|
15
|
+
- Documentation identifies version 0.6.0 as the published release and does not call it a release
|
|
16
|
+
candidate.
|
|
17
|
+
- Unit tests, typecheck, build and dependency audit remain green.
|
|
18
|
+
|
|
19
|
+
## Safety boundary
|
|
20
|
+
|
|
21
|
+
The checks in this gate are read-only or offline. They must not publish npm packages, sign or
|
|
22
|
+
broadcast a transaction, change production configuration, or count internal actors as M2 adoption.
|
|
@@ -8,11 +8,11 @@ import {
|
|
|
8
8
|
} from "@perkos/agent-sdk";
|
|
9
9
|
|
|
10
10
|
const transaction =
|
|
11
|
-
"
|
|
11
|
+
"0xb710a9560803fccd2ecd0f20ffbe784efb9476eaa2cedcf74c8dcba975387e2e";
|
|
12
12
|
const payer = "SP2K7PV5NXBNRV510S6DCA6RFMTFHAF3ZPK6ZSXPH";
|
|
13
|
-
const blockHeight =
|
|
13
|
+
const blockHeight = 8_886_273;
|
|
14
14
|
const blockHash =
|
|
15
|
-
"
|
|
15
|
+
"0x9c19ca3e008b3b645f155b74c70d525978dbda41caec92b93b60b6b61185c51c";
|
|
16
16
|
const config = resolveConfig({ network: "mainnet" });
|
|
17
17
|
const paymentRequired = createPerkOSX402PaymentRequired(config, {
|
|
18
18
|
resource: {
|
|
@@ -23,7 +23,7 @@ const paymentRequired = createPerkOSX402PaymentRequired(config, {
|
|
|
23
23
|
},
|
|
24
24
|
asset: "sbtc",
|
|
25
25
|
jobId: 1n,
|
|
26
|
-
amount:
|
|
26
|
+
amount: 100n,
|
|
27
27
|
maxTimeoutSeconds: 3_600,
|
|
28
28
|
});
|
|
29
29
|
const paymentPayload: PaymentPayload = {
|
|
@@ -34,7 +34,7 @@ const paymentPayload: PaymentPayload = {
|
|
|
34
34
|
transaction,
|
|
35
35
|
payer,
|
|
36
36
|
jobId: "1",
|
|
37
|
-
amount: "
|
|
37
|
+
amount: "100",
|
|
38
38
|
asset: "sbtc",
|
|
39
39
|
commerceContract: config.contracts.sbtcCommerce,
|
|
40
40
|
blockHeight,
|