@xyo-network/wallet-xl1-cli 0.1.21 → 0.1.22

package/dist/node/signing-types.d.ts

@@ -0,0 +1,76 @@
+import type { SignedHydratedTransactionWithHashMeta, UnsignedHydratedTransaction } from '@xyo-network/xl1-sdk';
+export interface SigningWalletSummary {
+    readonly algorithm: 'secp256k1' | 'ml-dsa-65';
+    readonly createdAt: number;
+    readonly id: string;
+    readonly isActive: boolean;
+    readonly label: string;
+    readonly walletKind: 'user' | 'os';
+}
+export interface OpenWalletSigningSessionOptions {
+    readonly chainId: string;
+    readonly expectedAccount: string;
+    readonly genesisBlockHash: string;
+    readonly offset: string;
+    readonly requesterId: string;
+    readonly ttlSeconds?: number;
+    readonly walletId: string;
+}
+export interface WalletSigningBinding {
+    readonly chainId: string;
+    readonly expectedAccount: string;
+    readonly generation: string;
+    readonly genesisBlockHash: string;
+    readonly offset: string;
+    readonly requesterId: string;
+    readonly walletId: string;
+}
+export interface WalletSigningSnapshot {
+    readonly binding: WalletSigningBinding;
+    readonly expiresAt: number;
+    readonly revision: number;
+    readonly scope: 'wallet:transactions:sign';
+    readonly state: 'active' | 'expired' | 'revoked' | 'locked';
+}
+export interface WalletSigningRequest {
+    readonly requestId: string;
+    readonly transaction: UnsignedHydratedTransaction;
+}
+export type WalletSigningOutcome = {
+    readonly requestId: string;
+    readonly state: 'unknown';
+} | {
+    readonly requestId: string;
+    readonly state: 'signed';
+    readonly transaction: SignedHydratedTransactionWithHashMeta;
+};
+export interface WalletSigningSession {
+    readonly binding: WalletSigningBinding;
+    close(): Promise<void>;
+    signTransaction(request: WalletSigningRequest): Promise<SignedHydratedTransactionWithHashMeta>;
+    signingOutcome(requestId: string): Promise<WalletSigningOutcome | undefined>;
+    snapshot(): Promise<WalletSigningSnapshot>;
+}
+export type WalletSigningErrorCode = 'invalid-request' | 'unauthorized' | 'expired' | 'revoked' | 'locked' | 'continuity-unqualified' | 'request-conflict' | 'signing-outcome-unknown' | 'capacity' | 'storage-unavailable';
+export declare class WalletSigningError extends Error {
+    readonly code: WalletSigningErrorCode;
+    readonly signingOutcome: 'not-attempted' | 'unknown';
+    constructor(code: WalletSigningErrorCode, outcome?: 'not-attempted' | 'unknown');
+}
+export interface WalletSigningContinuityMigration {
+    readonly assertion: 'exclusive-wallet-owner-cutover';
+    readonly checkpoint: {
+        readonly kind: 'unused';
+    } | {
+        readonly kind: 'signed';
+        readonly signed: unknown;
+    };
+    readonly expectedAccount: string;
+    readonly offset: string;
+    readonly walletId: string;
+}
+export interface WalletSigningContinuityCheckpoint {
+    readonly account: string;
+    readonly head: string | null;
+    readonly source: 'owner-cutover';
+}

package/dist/node/signing.d.ts

@@ -0,0 +1,9 @@
+import type { OpenWalletSigningSessionOptions, SigningWalletSummary, WalletSigningContinuityCheckpoint, WalletSigningContinuityMigration, WalletSigningSession } from './signing-types.js';
+export type { OpenWalletSigningSessionOptions, SigningWalletSummary, WalletSigningBinding, WalletSigningErrorCode, WalletSigningOutcome, WalletSigningRequest, WalletSigningSession, WalletSigningSnapshot, } from './signing-types.js';
+export { WalletSigningError } from './signing-types.js';
+export declare function listSigningWallets(): readonly SigningWalletSummary[];
+/** The wallet owner performs trusted approval and unlock; no key material crosses this API. */
+export declare function openWalletSigningSession(options: OpenWalletSigningSessionOptions): Promise<WalletSigningSession>;
+export type { WalletSigningContinuityCheckpoint, WalletSigningContinuityMigration } from './signing-types.js';
+/** Fresh wallet-owner cutover approval is separate from every requester grant. */
+export declare function migrateWalletSigningContinuity(options: WalletSigningContinuityMigration): Promise<WalletSigningContinuityCheckpoint>;