@perkos/agent-sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to `@perkos/agent-sdk` are documented here.
+
+## 0.1.0 - 2026-08-24
+
+### Added
+
+- Validated mainnet and testnet deployment configuration.
+- Read-only client for agents, jobs, escrow balances, payment-token configuration, and reputation.
+- Transaction-plan builders for agent registration and the complete STX/sBTC job lifecycle.
+- Exact funding and settlement post-conditions.
+- Pluggable signer interface with structured transaction receipts.
+- Included headless signer with an on-demand external key provider.
+- Included Stacks Connect signer adapter for Leather and compatible browser wallets.
+- Normalized transaction tracking with bounded polling, cancellation, terminal statuses, block
+  metadata, and Clarity result fields.
+- Client helpers to confirm a broadcast or execute and return a combined confirmation receipt.
+- Fail-closed spending policy with per-transaction and per-session limits.
+- Read-only mainnet quickstart and an opt-in transactional sBTC testnet lifecycle using distinct
+  client, provider, and evaluator roles.
+- Safe dry-run mode for the transactional quickstart, enabled by default.
+
+### Fixed
+
+- Resolve the package self-reference to source during development so clean CI environments can
+  typecheck the quickstart before `dist/` exists.
+- Reject malformed signer results instead of accepting non-transaction identifiers as broadcasts.
+- Use the Stacks node `/v2/info` endpoint for the transactional quickstart chain height and cover
+  the request with a regression test.
+- Hydrate terminal Clarity results from transaction detail when the v3 status response returns a
+  null result.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PerkOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,226 @@
+# `@perkos/agent-sdk`
+
+TypeScript SDK for agent identity, escrow settlement, and reputation on Stacks.
+
+PerkOS gives AI agents a programmable path to register, hire, fund work with STX or sBTC,
+submit deliverables, settle escrow, and build job-linked reputation.
+
+> Status: 0.1.0 developer release. Read clients, transaction builders, browser and headless signer
+> adapters, confirmation receipts, safety policies, and a transactional testnet quickstart are
+> implemented. x402/MCP adapters, external review, and adoption evidence remain before Milestone 2
+> completion.
+
+## Requirements
+
+- Node.js 20 or newer
+- npm 10 or newer
+
+## Install
+
+```bash
+npm install @perkos/agent-sdk
+```
+
+To develop from source:
+
+```bash
+git clone https://github.com/PerkOS-xyz/PerkOS-Agent-SDK.git
+cd PerkOS-Agent-SDK
+npm install
+npm run verify
+npm run quickstart
+```
+
+The quickstart performs public read-only calls and does not require a wallet or private key.
+Set `PERKOS_NETWORK=testnet` to read the testnet deployment.
+
+The transactional quickstart is also safe by default: it only prints a seven-step sBTC testnet
+lifecycle and its funding-policy decision.
+
+```bash
+npm run quickstart:testnet
+```
+
+Live testnet execution requires three distinct funded roles and the exact opt-in documented in
+[`examples/testnet.env.example`](examples/testnet.env.example). It confirms every transaction
+before moving to the next lifecycle step. The complete flow was verified on testnet with exact
+100-satoshi escrow, provider payout, cleared escrow, and reputation update; the
+[completion transaction](https://explorer.hiro.so/txid/0x5cf34295641a9291a2b6785d6db95a5c56b4d3b40d4281c86da194acd4c64248?chain=testnet)
+is publicly inspectable.
+
+## Read on-chain state
+
+```ts
+import { PerkOSClient } from "@perkos/agent-sdk";
+
+const perkos = new PerkOSClient({ network: "mainnet" });
+
+const agentCount = await perkos.getAgentCount();
+const sbtcJob = await perkos.getJob("sbtc", 1n);
+const escrow = await perkos.getEscrowBalance("sbtc", 1n);
+const reputation = await perkos.getReputation(
+  "SP000000000000000000002Q6VF78"
+);
+```
+
+Amounts are returned as `bigint`. sBTC values are satoshis and STX values are micro-STX.
+
+## Build a transaction plan
+
+Builders return explicit, inspectable plans. They do not sign, broadcast, or read environment
+variables.
+
+```ts
+const plan = perkos.transactions.registerAgent({
+  name: "Research Agent",
+  description: "Produces cited market research.",
+  wallet: "SP...",
+  endpoints: [{ name: "mcp", url: "https://agent.example/mcp" }],
+});
+
+console.log(plan.contract, plan.functionName, plan.functionArgs);
+```
+
+Funding plans require the sender and generate an exact post-condition:
+
+```ts
+const plan = perkos.transactions.fundJob({
+  asset: "sbtc",
+  jobId: 7n,
+  amount: 25_000n,
+  sender: "SP...",
+});
+```
+
+Settlement helpers read the job and escrow balance before building exact contract-principal
+post-conditions. This protects both wallet-originated and headless transactions from transferring
+more than the job requires.
+
+## Browser signer (Leather and other Stacks wallets)
+
+`StacksConnectSigner` adapts the official Stacks Connect request API. The application supplies
+the connected address and request function; the SDK forwards the complete plan and never receives
+wallet key material.
+
+```ts
+import { request } from "@stacks/connect";
+import { PerkOSClient, StacksConnectSigner } from "@perkos/agent-sdk";
+
+const signer = new StacksConnectSigner({
+  network: "mainnet",
+  address: connectedStacksAddress,
+  request,
+});
+const perkos = new PerkOSClient({ network: "mainnet", signer });
+```
+
+Install `@stacks/connect` in the browser application. Wallet discovery and account selection stay
+at the application boundary so the SDK cannot silently choose an account.
+
+## Headless signer
+
+`HeadlessSigner` requests key material only when deriving the public address or signing. It caches
+only the derived address. Use an external secret manager, KMS adapter, or another controlled key
+provider; never hardcode production keys.
+
+```ts
+import { HeadlessSigner, PerkOSClient } from "@perkos/agent-sdk";
+
+const signer = new HeadlessSigner({
+  network: "testnet",
+  privateKeyProvider: async () => loadKeyFromSecretManager(),
+});
+
+const perkos = new PerkOSClient({ network: "testnet", signer });
+```
+
+The callback may return a string or `Uint8Array`. The SDK copies and zeroes its local binary-key
+buffer after use; JavaScript strings cannot be reliably erased from memory.
+
+## Confirmation receipts
+
+Broadcast acceptance is not execution success. Confirm through the configured Stacks API before
+advancing an automated workflow:
+
+```ts
+const broadcast = await perkos.execute(plan);
+const confirmation = await perkos.confirm(broadcast, {
+  timeoutMs: 10 * 60_000,
+  pollIntervalMs: 5_000,
+});
+
+if (confirmation.status !== "success") {
+  throw new Error(`Transaction ended with ${confirmation.status}`);
+}
+```
+
+Confirmation status is normalized to `pending`, `success`, `abort`, `dropped`, or `timeout`, with
+block and Clarity-result fields when the API supplies them. Polling supports cancellation through
+an `AbortSignal`. If the v3 status response omits a terminal Clarity result, the tracker hydrates
+that field from the transaction-detail endpoint.
+
+## Spending policy
+
+Funding is fail-closed. Both limits must be configured for every spendable asset:
+
+```ts
+const perkos = new PerkOSClient({
+  network: "mainnet",
+  signer: new WalletSigner(),
+  spendingPolicy: {
+    allowedAssets: ["sbtc"],
+    maxPerTransaction: { sbtc: 50_000n },
+    maxPerSession: { sbtc: 150_000n },
+  },
+});
+
+await perkos.fundJob({
+  asset: "sbtc",
+  jobId: 7n,
+  amount: 25_000n,
+});
+```
+
+The policy also limits networks and contract principals. Funding attempts without explicit
+per-transaction and per-session limits are rejected before the signer is called.
+
+## Supported lifecycle
+
+- Register, update, and deactivate agents.
+- Read agent records and counts.
+- Create STX or sBTC jobs.
+- Set a budget and fund escrow.
+- Assign a provider and submit a deliverable.
+- Complete, reject, or expire a job.
+- Rate a provider and read reputation.
+
+## Security model
+
+- Mainnet or testnet must be selected explicitly.
+- Contract overrides must match the selected network.
+- Funding uses exact sender post-conditions.
+- Settlement uses exact escrow-contract post-conditions.
+- Agent-controlled payments require transaction and session budgets.
+- The core SDK never accepts arbitrary URLs or payment destinations from an LLM.
+- `execute` refuses plans created for a different network or signer.
+- Broadcast receipts require a valid 32-byte Stacks transaction ID.
+- Automated workflows can wait for an explicit terminal confirmation before their next action.
+
+This package has not yet completed the external security review required for PerkOS Milestone 2.
+Do not treat the developer release as audited software.
+
+See [Architecture](docs/ARCHITECTURE.md) and [Security](SECURITY.md) for the trust boundaries and
+responsible disclosure process.
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+## License
+
+MIT

package/SECURITY.md

@@ -0,0 +1,67 @@
+# Security
+
+## Release status
+
+`@perkos/agent-sdk` 0.1.0 is an M2 foundation release and has not completed the external security
+review required for the PerkOS Stacks Endowment milestone.
+
+Do not use this developer release to control material funds without your own review. Inspect every
+transaction plan in the signer and configure explicit spending limits.
+
+## Reporting a vulnerability
+
+Do not open a public issue for a suspected vulnerability. Send a private report to
+`security@perkos.xyz` with:
+
+- the affected version and network;
+- reproduction steps or a proof of concept;
+- the potential impact;
+- relevant contract IDs, transaction IDs, or logs;
+- a safe way to contact the reporter.
+
+The PerkOS team will acknowledge the report, validate it, and coordinate remediation and
+disclosure.
+
+## Implemented safeguards
+
+- Explicit network selection and network-compatible contract validation.
+- Exact post-conditions for wallet funding.
+- Exact escrow-contract post-conditions for completion, rejection, and refunds.
+- Contract and asset allowlists.
+- Required per-transaction and per-session funding limits.
+- Funding-limit checks occur before requesting a signer address.
+- Signer-address matching for funding plans.
+- No automatic environment-variable or private-key loading.
+- No arbitrary URL or payment-destination execution surface in the core SDK.
+- Strict validation and normalization of signer-returned Stacks transaction IDs.
+- Bounded, cancellable confirmation polling with explicit abort, dropped, and timeout states.
+- Network mismatch rejection in both browser and headless signer adapters.
+
+## Key handling
+
+`StacksConnectSigner` delegates signing to the wallet extension and never receives a private key.
+The host application must select the intended account and show the wallet approval surface.
+
+`HeadlessSigner` calls an application-owned `privateKeyProvider` only when it needs to derive the
+public address or sign. It caches only the public address. When the provider returns a
+`Uint8Array`, the SDK signs with a copy and zeroes that local copy after the operation. JavaScript
+strings are immutable and cannot be reliably erased; use binary key material and an isolated
+secret provider when the runtime permits it.
+
+The SDK does not make an unsafe runtime safe. Restrict process access, rotate credentials, separate
+client/provider/evaluator identities, and use an HSM, KMS, or isolated signer for material funds.
+
+## Confirmation handling
+
+A broadcast receipt means a node accepted the transaction, not that the contract call succeeded.
+Automated workflows should call `confirm` or `executeAndConfirm`, require `success`, inspect the
+Clarity result, and choose an additional confirmation threshold appropriate to the value at risk.
+Treat transaction APIs as external dependencies and retain the transaction ID for independent
+verification.
+
+## Trust boundaries
+
+The SDK prepares, validates, and submits transaction plans through an application-provided
+signer. It does not prove that the signer implementation is safe. Applications must protect
+private keys, verify wallet prompts, authenticate agent commands, and treat external tool or
+model output as untrusted.

package/dist/builders.d.ts

@@ -0,0 +1,19 @@
+import type { AssignProviderInput, ContractCallPlan, CreateJobInput, FundJobInput, JobAmountInput, RateProviderInput, RegisterAgentInput, ResolvedPerkOSConfig, SettleJobInput, SubmitWorkInput, UpdateAgentInput } from "./types.js";
+export declare class PerkOSTransactionBuilder {
+    readonly config: ResolvedPerkOSConfig;
+    constructor(config: ResolvedPerkOSConfig);
+    registerAgent(input: RegisterAgentInput): ContractCallPlan;
+    updateAgent(input: UpdateAgentInput): ContractCallPlan;
+    deactivateAgent(agentIdInput: bigint | number | string): ContractCallPlan;
+    createJob(input: CreateJobInput): ContractCallPlan;
+    setBudget(input: JobAmountInput): ContractCallPlan;
+    fundJob(input: FundJobInput): ContractCallPlan;
+    assignProvider(input: AssignProviderInput): ContractCallPlan;
+    submitWork(input: SubmitWorkInput): ContractCallPlan;
+    completeJob(input: SettleJobInput): ContractCallPlan;
+    rejectJob(input: SettleJobInput): ContractCallPlan;
+    expireJob(input: SettleJobInput): ContractCallPlan;
+    rateProvider(input: RateProviderInput): ContractCallPlan;
+    private settlement;
+}
+//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAEhB,cAAc,EACd,YAAY,EACZ,cAAc,EAEd,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA6EpB,qBAAa,wBAAwB;IACnC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;gBAE1B,MAAM,EAAE,oBAAoB;IAIxC,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,gBAAgB;IA8B1D,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB;IAuBtD,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,gBAAgB;IAWzE,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB;IAsBlD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB;IAYlD,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB;IA2B9C,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,gBAAgB;IAiB5D,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB;IAWpD,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB;IAIpD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB;IAIlD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,gBAAgB;IAIlD,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB;IAgBxD,OAAO,CAAC,UAAU;CAyBnB"}

package/dist/builders.js

@@ -0,0 +1,180 @@
+import { Cl, Pc } from "@stacks/transactions";
+import { PerkOSError } from "./errors.js";
+import { assertAscii, assertPrincipal, parseContractId, toUint, } from "./validation.js";
+function commerceContract(config, asset) {
+    return asset === "sbtc" ? config.contracts.sbtcCommerce : config.contracts.stxCommerce;
+}
+function plan(config, contract, functionName, functionArgs, intent, postConditions = []) {
+    return {
+        type: "contract-call",
+        network: config.network,
+        contract,
+        functionName,
+        functionArgs,
+        postConditions,
+        postConditionMode: "deny",
+        intent,
+    };
+}
+function tokenArg(config) {
+    const token = parseContractId(config.contracts.sbtcToken, "contracts.sbtcToken", config.network);
+    return Cl.contractPrincipal(token.address, token.name);
+}
+function escrowArgs(config, asset, baseArgs) {
+    return asset === "sbtc" ? [...baseArgs, tokenArg(config)] : baseArgs;
+}
+function exactTransfer(config, asset, sender, amount) {
+    if (asset === "stx") {
+        return Pc.principal(sender).willSendEq(amount).ustx();
+    }
+    return Pc.principal(sender)
+        .willSendEq(amount)
+        .ft(config.contracts.sbtcToken, config.contracts.sbtcAssetName);
+}
+function deliverableBuffer(value) {
+    const bytes = typeof value === "string"
+        ? new TextEncoder().encode(value)
+        : Uint8Array.from(value);
+    if (bytes.length === 0 || bytes.length > 64) {
+        throw new PerkOSError("INPUT_INVALID", "deliverable must contain between 1 and 64 bytes.", { bytes: bytes.length });
+    }
+    if (typeof value === "string") {
+        assertAscii(value, "deliverable", 64);
+    }
+    return bytes;
+}
+export class PerkOSTransactionBuilder {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    registerAgent(input) {
+        assertAscii(input.name, "name", 64);
+        assertAscii(input.description, "description", 256);
+        assertPrincipal(input.wallet, "wallet", this.config.network);
+        const endpoints = input.endpoints ?? [];
+        if (endpoints.length > 10) {
+            throw new PerkOSError("INPUT_INVALID", "endpoints cannot contain more than 10 entries.");
+        }
+        const endpointCVs = endpoints.map((endpoint, index) => {
+            assertAscii(endpoint.name, `endpoints[${index}].name`, 32);
+            assertAscii(endpoint.url, `endpoints[${index}].url`, 128);
+            return Cl.tuple({
+                name: Cl.stringAscii(endpoint.name),
+                url: Cl.stringAscii(endpoint.url),
+            });
+        });
+        return plan(this.config, this.config.contracts.agentRegistry, "register-agent", [
+            Cl.stringAscii(input.name),
+            Cl.stringAscii(input.description),
+            Cl.principal(input.wallet),
+            Cl.list(endpointCVs),
+        ], { operation: "register-agent" });
+    }
+    updateAgent(input) {
+        const agentId = toUint(input.agentId, "agentId");
+        if (input.name !== undefined)
+            assertAscii(input.name, "name", 64);
+        if (input.description !== undefined)
+            assertAscii(input.description, "description", 256);
+        if (input.wallet !== undefined) {
+            assertPrincipal(input.wallet, "wallet", this.config.network);
+        }
+        return plan(this.config, this.config.contracts.agentRegistry, "update-agent", [
+            Cl.uint(agentId),
+            input.name === undefined ? Cl.none() : Cl.some(Cl.stringAscii(input.name)),
+            input.description === undefined
+                ? Cl.none()
+                : Cl.some(Cl.stringAscii(input.description)),
+            input.wallet === undefined ? Cl.none() : Cl.some(Cl.principal(input.wallet)),
+        ], { operation: "update-agent" });
+    }
+    deactivateAgent(agentIdInput) {
+        const agentId = toUint(agentIdInput, "agentId");
+        return plan(this.config, this.config.contracts.agentRegistry, "deactivate-agent", [Cl.uint(agentId)], { operation: "deactivate-agent" });
+    }
+    createJob(input) {
+        assertPrincipal(input.evaluator, "evaluator", this.config.network);
+        if (input.provider)
+            assertPrincipal(input.provider, "provider", this.config.network);
+        if (input.provider === input.evaluator) {
+            throw new PerkOSError("INPUT_INVALID", "provider and evaluator must be different.");
+        }
+        assertAscii(input.description, "description", 512);
+        const expiredAt = toUint(input.expiredAt, "expiredAt");
+        return plan(this.config, commerceContract(this.config, input.asset), "create-job", [
+            input.provider ? Cl.some(Cl.principal(input.provider)) : Cl.none(),
+            Cl.principal(input.evaluator),
+            Cl.uint(expiredAt),
+            Cl.stringAscii(input.description),
+        ], { operation: "create-job", asset: input.asset });
+    }
+    setBudget(input) {
+        const jobId = toUint(input.jobId, "jobId");
+        const amount = toUint(input.amount, "amount");
+        return plan(this.config, commerceContract(this.config, input.asset), "set-budget", [Cl.uint(jobId), Cl.uint(amount)], { operation: "set-budget", asset: input.asset, amount, jobId });
+    }
+    fundJob(input) {
+        const jobId = toUint(input.jobId, "jobId");
+        const amount = toUint(input.amount, "amount");
+        if (!input.sender) {
+            throw new PerkOSError("INPUT_INVALID", "sender is required to create the exact funding post-condition.");
+        }
+        assertPrincipal(input.sender, "sender", this.config.network);
+        const contract = commerceContract(this.config, input.asset);
+        return plan(this.config, contract, "fund-job", escrowArgs(this.config, input.asset, [Cl.uint(jobId)]), {
+            operation: "fund-job",
+            asset: input.asset,
+            amount,
+            jobId,
+            sender: input.sender,
+        }, [exactTransfer(this.config, input.asset, input.sender, amount)]);
+    }
+    assignProvider(input) {
+        const jobId = toUint(input.jobId, "jobId");
+        assertPrincipal(input.provider, "provider", this.config.network);
+        return plan(this.config, commerceContract(this.config, input.asset), "assign-provider", [Cl.uint(jobId), Cl.principal(input.provider)], {
+            operation: "assign-provider",
+            asset: input.asset,
+            jobId,
+            recipient: input.provider,
+        });
+    }
+    submitWork(input) {
+        const jobId = toUint(input.jobId, "jobId");
+        return plan(this.config, commerceContract(this.config, input.asset), "submit-work", [Cl.uint(jobId), Cl.buffer(deliverableBuffer(input.deliverable))], { operation: "submit-work", asset: input.asset, jobId });
+    }
+    completeJob(input) {
+        return this.settlement("complete-job", input);
+    }
+    rejectJob(input) {
+        return this.settlement("reject-job", input);
+    }
+    expireJob(input) {
+        return this.settlement("expire-job", input);
+    }
+    rateProvider(input) {
+        const jobId = toUint(input.jobId, "jobId");
+        const score = toUint(input.score, "score");
+        if (score > 5n) {
+            throw new PerkOSError("INPUT_INVALID", "score must be between 1 and 5.");
+        }
+        assertAscii(input.comment, "comment", 256, true);
+        return plan(this.config, commerceContract(this.config, input.asset), "rate-provider", [Cl.uint(jobId), Cl.uint(score), Cl.stringAscii(input.comment)], { operation: "rate-provider", asset: input.asset, jobId });
+    }
+    settlement(operation, input) {
+        const jobId = toUint(input.jobId, "jobId");
+        const amount = toUint(input.amount, "amount", true);
+        assertPrincipal(input.recipient, "recipient", this.config.network);
+        const contract = commerceContract(this.config, input.asset);
+        const postConditions = amount > 0n ? [exactTransfer(this.config, input.asset, contract, amount)] : [];
+        return plan(this.config, contract, operation, escrowArgs(this.config, input.asset, [Cl.uint(jobId)]), {
+            operation,
+            asset: input.asset,
+            amount,
+            jobId,
+            recipient: input.recipient,
+        }, postConditions);
+    }
+}
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

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

package/dist/clarity.d.ts

@@ -0,0 +1,11 @@
+import type { ClarityValue, TupleCV } from "@stacks/transactions";
+export declare function unwrapResponse(value: ClarityValue, context: string): ClarityValue;
+export declare function expectTuple(value: ClarityValue, context: string): TupleCV["value"];
+export declare function expectList(value: ClarityValue, context: string): readonly ClarityValue[];
+export declare function expectUint(value: ClarityValue | undefined, context: string): bigint;
+export declare function expectString(value: ClarityValue | undefined, context: string): string;
+export declare function expectPrincipal(value: ClarityValue | undefined, context: string): string;
+export declare function expectBoolean(value: ClarityValue | undefined, context: string): boolean;
+export declare function optionalPrincipal(value: ClarityValue | undefined, context: string): string | undefined;
+export declare function optionalBuffer(value: ClarityValue | undefined, context: string): string | undefined;
+//# sourceMappingURL=clarity.d.ts.map

package/dist/clarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarity.d.ts","sourceRoot":"","sources":["../src/clarity.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAKZ,OAAO,EACR,MAAM,sBAAsB,CAAC;AAQ9B,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAsBjF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,CAKxF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKnF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQrF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CASxF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKvF;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAUpB"}

package/dist/clarity.js

@@ -0,0 +1,80 @@
+import { ClarityType } from "@stacks/transactions";
+import { CLARITY_ERROR_MESSAGES } from "./constants.js";
+import { PerkOSError } from "./errors.js";
+function cvType(value) {
+    return String(value.type);
+}
+export function unwrapResponse(value, context) {
+    if (value.type === ClarityType.ResponseOk) {
+        return value.value;
+    }
+    if (value.type === ClarityType.ResponseErr) {
+        const errorValue = value.value;
+        const clarityCode = errorValue.type === ClarityType.UInt || errorValue.type === ClarityType.Int
+            ? BigInt(errorValue.value)
+            : undefined;
+        const knownMessage = clarityCode !== undefined ? CLARITY_ERROR_MESSAGES[Number(clarityCode)] : undefined;
+        throw new PerkOSError("CONTRACT_ERROR", knownMessage ?? `${context} returned a Clarity error.`, clarityCode === undefined ? undefined : { clarityCode });
+    }
+    throw new PerkOSError("READ_FAILED", `${context} returned ${cvType(value)} instead of a Clarity response.`);
+}
+export function expectTuple(value, context) {
+    if (value.type !== ClarityType.Tuple) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity tuple.`);
+    }
+    return value.value;
+}
+export function expectList(value, context) {
+    if (value.type !== ClarityType.List) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity list.`);
+    }
+    return value.value;
+}
+export function expectUint(value, context) {
+    if (!value || value.type !== ClarityType.UInt) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity uint.`);
+    }
+    return BigInt(value.value);
+}
+export function expectString(value, context) {
+    if (!value ||
+        (value.type !== ClarityType.StringASCII && value.type !== ClarityType.StringUTF8)) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity string.`);
+    }
+    return value.value;
+}
+export function expectPrincipal(value, context) {
+    if (!value ||
+        (value.type !== ClarityType.PrincipalStandard &&
+            value.type !== ClarityType.PrincipalContract)) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity principal.`);
+    }
+    return value.value;
+}
+export function expectBoolean(value, context) {
+    if (!value || (value.type !== ClarityType.BoolTrue && value.type !== ClarityType.BoolFalse)) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity boolean.`);
+    }
+    return value.type === ClarityType.BoolTrue;
+}
+export function optionalPrincipal(value, context) {
+    if (!value || value.type === ClarityType.OptionalNone)
+        return undefined;
+    if (value.type !== ClarityType.OptionalSome) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity optional.`);
+    }
+    return expectPrincipal(value.value, context);
+}
+export function optionalBuffer(value, context) {
+    if (!value || value.type === ClarityType.OptionalNone)
+        return undefined;
+    if (value.type !== ClarityType.OptionalSome) {
+        throw new PerkOSError("READ_FAILED", `${context} must be a Clarity optional.`);
+    }
+    const inner = value.value;
+    if (inner.type !== ClarityType.Buffer) {
+        throw new PerkOSError("READ_FAILED", `${context} must contain a Clarity buffer.`);
+    }
+    return inner.value;
+}
+//# sourceMappingURL=clarity.js.map