@perkos/agent-sdk 0.6.0 → 0.7.1
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 +50 -0
- package/README.md +71 -20
- 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 +48 -4
- 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/docs/ARCHITECTURE.md +13 -13
- 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/docs/ARCHITECTURE.md
CHANGED
|
@@ -144,19 +144,19 @@ profile.
|
|
|
144
144
|
Completion, rejection, expiry and versioned review-timeout settlement may transfer funds held by
|
|
145
145
|
the escrow contract rather than by the transaction origin. High-level client methods read the
|
|
146
146
|
current job and escrow balance before building the plan. The resulting post-condition identifies
|
|
147
|
-
the escrow contract principal and the exact amount expected to leave it. For `sbtc-commerce-v2
|
|
148
|
-
and `sbtc-commerce-
|
|
149
|
-
fungible-token post-condition; a later default-token
|
|
150
|
-
existing escrow.
|
|
151
|
-
|
|
152
|
-
The active v4
|
|
153
|
-
The
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
Reputation synchronization has its own durable read record and deny-mode retry plan so
|
|
157
|
-
unavailability never expands payment authority or rolls back
|
|
158
|
-
|
|
159
|
-
Versioned v4/v3
|
|
147
|
+
the escrow contract principal and the exact amount expected to leave it. For `sbtc-commerce-v2`,
|
|
148
|
+
`sbtc-commerce-v3` and `sbtc-commerce-v4`, the client also reads the job-pinned token and uses it
|
|
149
|
+
in both the contract argument and exact fungible-token post-condition; a later default-token
|
|
150
|
+
rotation cannot redirect or strand an existing escrow.
|
|
151
|
+
|
|
152
|
+
The active v5/v4 generation records a fixed 12 Bitcoin burn-block review deadline at submission.
|
|
153
|
+
The evaluator records a hashed decision without moving escrow, after which the affected client or
|
|
154
|
+
provider receives the configured appeal window. A separately pinned human authority resolves an
|
|
155
|
+
appeal; permissionless finalizers preserve liveness after either deadline without choosing a new
|
|
156
|
+
recipient. Reputation synchronization has its own durable read record and deny-mode retry plan so
|
|
157
|
+
registry unavailability never expands payment authority or rolls back settlement.
|
|
158
|
+
|
|
159
|
+
Versioned v5/v4/v3 contract IDs are the defaults on both networks. Historical generations remain
|
|
160
160
|
available through explicit same-network overrides.
|
|
161
161
|
|
|
162
162
|
## Future adapters
|
|
@@ -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,
|