@secondlayer/sdk 6.54.1 → 8.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/sdk",
-	"version": "6.54.1",
+	"version": "8.0.0",
 	"license": "MIT",
 	"repository": {
 		"type": "git",
@@ -28,10 +28,6 @@
 			"types": "./dist/subgraphs/index.d.ts",
 			"import": "./dist/subgraphs/index.js"
 		},
-		"./x402": {
-			"types": "./dist/x402.d.ts",
-			"import": "./dist/x402.js"
-		},
 		"./sinks/core": {
 			"types": "./dist/sinks/core.d.ts",
 			"import": "./dist/sinks/core.js"
@@ -63,9 +59,9 @@
 		"prepublishOnly": "bun run build"
 	},
 	"dependencies": {
-		"@secondlayer/shared": "^7.11.0",
-		"@secondlayer/stacks": "^3.2.0",
-		"@secondlayer/subgraphs": "^3.26.3"
+		"@secondlayer/shared": "^9.0.0",
+		"@secondlayer/stacks": "^4.0.0",
+		"@secondlayer/subgraphs": "^4.0.1"
 	},
 	"devDependencies": {
 		"@openpkg-ts/cli": "^0.11.3",

package/dist/x402.d.ts

@@ -1,160 +0,0 @@
-import { X402TokenSymbol } from "@secondlayer/shared/x402";
-import { LocalAccount } from "@secondlayer/stacks/accounts";
-import { StacksChain } from "@secondlayer/stacks/chains";
-/**
-* Client for the x402 pay-per-request rail. Turns a 402 challenge into a signed
-* `PAYMENT-SIGNATURE` and retries — gasless (the agent signs origin-only; the
-* facilitator sponsors the STX fee) and accountless (no key/Stripe/session).
-*
-* Three layers:
-*  - `withX402(fetch, opts)` — drop-in fetch that auto-pays on 402.
-*  - `createX402Client(opts)` — `.get/.post` returning `{ data, payment }`.
-*  - `buildSignedX402Payment` / `readX402Challenge` — primitives for custom transports.
-*/
-type X402Accept = {
-	scheme: "exact";
-	network: string;
-	asset: string;
-	/** Atomic units. */
-	amount: string;
-	payTo: string;
-	maxTimeoutSeconds: number;
-	extra: {
-		nonce: string;
-	};
-};
-type X402Challenge = {
-	x402Version: number;
-	accepts: X402Accept[];
-	error?: string;
-};
-/** Decoded `PAYMENT-RESPONSE` settlement receipt. */
-type X402Receipt = {
-	success: boolean;
-	/** Settlement tier: `optimistic` (served on broadcast-accept, reconciled
-	*  async) or `confirmed` (canonical). Absent on older deployments. */
-	state?: "optimistic" | "confirmed";
-	txid: string;
-	payer: string;
-	network: string;
-};
-/** Bitcoin-native first — sBTC is the compelling micropay asset; USDCx the
-*  dollar peg; STX the fallback. Override via `preferAssets`. */
-declare const DEFAULT_PREFER_ASSETS: X402TokenSymbol[];
-/** Default node for auto-resolving the payer's account nonce (`/v2/accounts`). */
-declare const DEFAULT_NONCE_NODE_URL = "https://api.hiro.so";
-/** Thrown when no offered asset is within the caller's spend guard / preferences. */
-declare class X402SpendGuardError extends Error {
-	constructor(message: string);
-}
-/** Read the x402 challenge from a 402 response — prefer the wire header, fall
-*  back to the JSON body. */
-declare function readX402Challenge(res: Response): Promise<X402Challenge | null>;
-/** Read the settlement receipt from a paid 200 response. */
-declare function readX402Receipt(res: Response): X402Receipt | null;
-type SelectOfferOptions = {
-	preferAssets?: X402TokenSymbol[];
-	maxAmountPerCall?: Partial<Record<X402TokenSymbol, bigint>>;
-};
-/** Choose an `accepts[]` entry by preference order, skipping any that exceed the
-*  per-asset spend cap. Throws {@link X402SpendGuardError} if none qualify. */
-declare function selectOffer(challenge: X402Challenge, opts?: SelectOfferOptions): {
-	accept: X402Accept;
-	symbol: X402TokenSymbol;
-};
-/** Fetch the payer account's next nonce from a Stacks node (`/v2/accounts`). */
-declare function resolveAccountNonce(address: string, nodeUrl?: string): Promise<number>;
-type BuildSignedX402PaymentOptions = {
-	challenge: X402Challenge;
-	account: LocalAccount;
-	/** The payer account's next nonce. */
-	accountNonce: bigint | number | string;
-	/** Preferred asset string (e.g. an sBTC/USDCx id). Defaults to the first offer. */
-	asset?: string;
-	chain?: StacksChain;
-};
-/** Build a signed, base64 `PAYMENT-SIGNATURE` header for one `accepts[]` entry. */
-declare function buildSignedX402Payment(opts: BuildSignedX402PaymentOptions): Promise<{
-	header: string;
-	accept: X402Accept;
-}>;
-type WithX402Options = SelectOfferOptions & {
-	account: LocalAccount;
-	/** Prepaid-credit token (PAYMENT-BALANCE) from a prior deposit — calls
-	*  debit the tab server-side instead of settling on-chain per call. */
-	balanceToken?: string;
-	/** Autonomous treasury policy: when the tab's remaining balance (read from
-	*  X-BALANCE-REMAINING-USD) drops below `whenBelow`, deposit `usd` more in
-	*  the background (one on-chain payment) and adopt the fresh token. */
-	topUp?: {
-		usd: number;
-		whenBelow: number;
-	};
-	/** Override the payer nonce; auto-resolved from `nodeUrl` when omitted. */
-	accountNonce?: bigint | number | string;
-	/** Node for auto-nonce lookup. Defaults to {@link DEFAULT_NONCE_NODE_URL}. */
-	nodeUrl?: string;
-	chain?: StacksChain;
-	/** Fired just before the paid retry (the call then blocks on confirmed-tier
-	*  settle, or returns near-instantly on an optimistic surface). */
-	onSettling?: (info: {
-		asset: string;
-		amount: string;
-	}) => void;
-	/** Abort the paid retry after this long. */
-	timeoutMs?: number;
-};
-type X402Fetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
-/**
-* Wrap a `fetch` so requests transparently pay on 402: select an offer (by
-* `preferAssets` + `maxAmountPerCall`), resolve the nonce, sign origin-only, and
-* retry once with `PAYMENT-SIGNATURE`. Returns the final `Response` (read the
-* receipt with {@link readX402Receipt}).
-*
-* @example
-* const x402fetch = withX402(fetch, { account });
-* const res = await x402fetch("http://127.0.0.1:3800/v1/index/events?event_type=ft_transfer");
-*/
-declare function withX402(baseFetch: typeof fetch, opts: WithX402Options): X402Fetch;
-type X402ClientOptions = WithX402Options & {
-	/** Instance API. Defaults to {@link resolveBaseUrl}. */
-	baseUrl?: string;
-	/** Override the underlying fetch (tests). */
-	fetch?: typeof fetch;
-};
-type X402Result<T = unknown> = {
-	data: T;
-	/** Settlement receipt, or null if the response carried none. */
-	payment: X402Receipt | null;
-	response: Response;
-};
-type X402Client = {
-	get<T = unknown>(path: string, o?: {
-		query?: Record<string, string>;
-	}): Promise<X402Result<T>>;
-	post<T = unknown>(path: string, o?: {
-		body?: unknown;
-	}): Promise<X402Result<T>>;
-};
-/**
-* A small client over {@link withX402}: `.get/.post` against `baseUrl`, returning
-* parsed JSON plus the settlement receipt.
-*
-* @example
-* const sl = createX402Client({ account, baseUrl: "http://127.0.0.1:3800" });
-* const { data, payment } = await sl.get("/v1/index/events", { query: { event_type: "ft_transfer" } });
-*/
-declare function createX402Client(opts: X402ClientOptions): X402Client;
-/** Caller-supplied fetch that re-runs the request with the given extra headers. */
-type X402FetchFn = (extraHeaders: Record<string, string>) => Promise<Response>;
-type PayAndRetryOptions = Omit<WithX402Options, never> & {
-	/** Required here (use `withX402` for auto-nonce). */
-	accountNonce: bigint | number | string;
-};
-/**
-* Low-level: run a request via a caller-controlled fetch; if it 402s, pay and
-* retry once. Prefer {@link withX402} for the common case (it auto-resolves the
-* nonce + selects the asset). Kept for custom transports.
-*/
-declare function payAndRetry(doFetch: X402FetchFn, opts: PayAndRetryOptions): Promise<Response>;
-export { withX402, selectOffer, resolveAccountNonce, readX402Receipt, readX402Challenge, payAndRetry, createX402Client, buildSignedX402Payment, X402SpendGuardError, X402Result, X402Receipt, X402FetchFn, X402Fetch, X402ClientOptions, X402Client, X402Challenge, X402Accept, WithX402Options, SelectOfferOptions, PayAndRetryOptions, DEFAULT_PREFER_ASSETS, DEFAULT_NONCE_NODE_URL, BuildSignedX402PaymentOptions };