@sundaeswap/sprinkles 0.4.0 → 0.5.0

package/dist/types/Sprinkle/schemas.d.ts

@@ -0,0 +1,125 @@
+import type { TExact } from "./types.js";
+/**
+ * Network selection schema (mainnet, preview, preprod).
+ */
+export declare const NetworkSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"mainnet">, import("@sinclair/typebox").TLiteral<"preview">, import("@sinclair/typebox").TLiteral<"preprod">]>;
+/**
+ * Recursive multisig script module for Cardano native scripts.
+ */
+export declare const MultisigScriptModule: import("@sinclair/typebox").TModule<{
+    MultisigScript: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        Signature: import("@sinclair/typebox").TObject<{
+            key_hash: import("@sinclair/typebox").TString;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AllOf: import("@sinclair/typebox").TObject<{
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AnyOf: import("@sinclair/typebox").TObject<{
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AtLeast: import("@sinclair/typebox").TObject<{
+            required: import("@sinclair/typebox").TBigInt;
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        Before: import("@sinclair/typebox").TObject<{
+            time: import("@sinclair/typebox").TBigInt;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        After: import("@sinclair/typebox").TObject<{
+            time: import("@sinclair/typebox").TBigInt;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        Script: import("@sinclair/typebox").TObject<{
+            script_hash: import("@sinclair/typebox").TString;
+        }>;
+    }>]>;
+}, {
+    MultisigScript: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        Signature: import("@sinclair/typebox").TObject<{
+            key_hash: import("@sinclair/typebox").TString;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AllOf: import("@sinclair/typebox").TObject<{
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AnyOf: import("@sinclair/typebox").TObject<{
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AtLeast: import("@sinclair/typebox").TObject<{
+            required: import("@sinclair/typebox").TBigInt;
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        Before: import("@sinclair/typebox").TObject<{
+            time: import("@sinclair/typebox").TBigInt;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        After: import("@sinclair/typebox").TObject<{
+            time: import("@sinclair/typebox").TBigInt;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        Script: import("@sinclair/typebox").TObject<{
+            script_hash: import("@sinclair/typebox").TString;
+        }>;
+    }>]>;
+}>;
+export declare const MultisigScript: import("@sinclair/typebox").TImport<{
+    MultisigScript: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        Signature: import("@sinclair/typebox").TObject<{
+            key_hash: import("@sinclair/typebox").TString;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AllOf: import("@sinclair/typebox").TObject<{
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AnyOf: import("@sinclair/typebox").TObject<{
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        AtLeast: import("@sinclair/typebox").TObject<{
+            required: import("@sinclair/typebox").TBigInt;
+            scripts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRef<"MultisigScript">>;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        Before: import("@sinclair/typebox").TObject<{
+            time: import("@sinclair/typebox").TBigInt;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        After: import("@sinclair/typebox").TObject<{
+            time: import("@sinclair/typebox").TBigInt;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{
+        Script: import("@sinclair/typebox").TObject<{
+            script_hash: import("@sinclair/typebox").TString;
+        }>;
+    }>]>;
+}, "MultisigScript">;
+export type TMultisigScript = TExact<typeof MultisigScript>;
+/**
+ * Provider settings schema for blockchain data providers.
+ */
+export declare const ProviderSettingsSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"blockfrost">;
+    projectId: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"maestro">;
+    apiKey: import("@sinclair/typebox").TString;
+}>]>;
+/**
+ * Wallet settings schema for hot and cold wallets.
+ */
+export declare const WalletSettingsSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"hot">;
+    privateKey: import("@sinclair/typebox").TString;
+}>, import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"cold">;
+    address: import("@sinclair/typebox").TString;
+}>]>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/types/Sprinkle/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/Sprinkle/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,aAAa,yLAIxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4D/B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAAgD,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;IASjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;IAa/B,CAAC"}

package/dist/types/Sprinkle/tx-dialog.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Transaction dialog helper utilities.
+ * Functions for working with transaction signatures and display.
+ */
+import { Core, HotWallet } from "@blaze-cardano/sdk";
+/**
+ * Get the payment key hash from a HotWallet's first address.
+ */
+export declare function getWalletPaymentKeyHash(wallet: HotWallet): Promise<string | null>;
+/**
+ * Count the number of vkey signatures in a transaction's witness set.
+ */
+export declare function countSignatures(tx: Core.Transaction): number;
+/**
+ * Check if a specific public key has already signed the transaction.
+ * Compares by vkey (public key bytes).
+ */
+export declare function hasVkeySigned(tx: Core.Transaction, vkeyHex: string): boolean;
+/**
+ * Get the list of required signer key hashes from the transaction body.
+ */
+export declare function getRequiredSigners(tx: Core.Transaction): string[];
+/**
+ * Compute the transaction body hash for display.
+ */
+export declare function getTxBodyHash(tx: Core.Transaction): string;
+/**
+ * Format a hash for display: first 8 chars + ... + last 8 chars.
+ */
+export declare function formatHash(hash: string): string;
+/**
+ * Merge signatures from source transaction into target transaction.
+ * Prevents duplicate signatures by comparing vkey (public key).
+ * Returns the count of newly added signatures.
+ */
+export declare function mergeSignatures(target: Core.Transaction, source: Core.Transaction): number;
+//# sourceMappingURL=tx-dialog.d.ts.map

package/dist/types/Sprinkle/tx-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-dialog.d.ts","sourceRoot":"","sources":["../../../src/Sprinkle/tx-dialog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAG5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,GAAG,MAAM,EAAE,CAIjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,GAAG,MAAM,CAG1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,IAAI,CAAC,WAAW,EACxB,MAAM,EAAE,IAAI,CAAC,WAAW,GACvB,MAAM,CAsBR"}

package/dist/types/Sprinkle/type-guards.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Type guard utilities for TypeBox schema types.
+ * These are internal helpers used by FillInStruct, encryption, and other modules.
+ */
+import { type TBigInt, type TLiteral, type TObject, type TSchema, type TString, type TTuple, type TUnion, type TArray, type TThis, type TRef, type TImport, type TOptional } from "@sinclair/typebox";
+export declare const isOptional: <T extends TSchema>(t: T) => t is TOptional<T>;
+export declare const isImport: (t: TSchema) => t is TImport;
+export declare const isArray: (t: TSchema) => t is TArray;
+export declare const isBigInt: (t: TSchema) => t is TBigInt;
+export declare const isLiteral: (t: TSchema) => t is TLiteral;
+export declare const isObject: (t: TSchema) => t is TObject;
+export declare const isRef: (t: TSchema) => t is TRef;
+export declare const isString: (t: TSchema) => t is TString;
+export declare const isThis: (t: TSchema) => t is TThis;
+export declare const isTuple: (t: TSchema) => t is TTuple;
+export declare const isUnion: (t: TSchema) => t is TUnion;
+/**
+ * Check if a schema field is marked as sensitive.
+ * Sensitive fields are encrypted when saved and masked when displayed.
+ */
+export declare const isSensitive: (t: TSchema) => boolean;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/types/Sprinkle/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../../src/Sprinkle/type-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,SAAS,EAEf,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,OAAO,EAAE,GAAG,CAAC,KAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CACrC,CAAC;AAEjC,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,OAA+B,CAAC;AAE3E,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,MAA6B,CAAC;AAExE,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,OAA+B,CAAC;AAE3E,eAAO,MAAM,SAAS,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,QAAiC,CAAC;AAE9E,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,OAA+B,CAAC;AAE3E,eAAO,MAAM,KAAK,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,IAAyB,CAAC;AAElE,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,OAA+B,CAAC;AAE3E,eAAO,MAAM,MAAM,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,KAA2B,CAAC;AAErE,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,MAA6B,CAAC;AAExE,eAAO,MAAM,OAAO,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,MAA6B,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,GAAG,OAAO,KAAG,OACJ,CAAC"}

package/dist/types/Sprinkle/types.d.ts

@@ -0,0 +1,62 @@
+import { Core } from "@blaze-cardano/sdk";
+import type { Static, TSchema } from "@sinclair/typebox";
+/**
+ * Utility type to extract the static type from a TypeBox schema.
+ */
+export type TExact<T> = T extends TSchema ? Static<T> : T;
+/**
+ * Options for encrypting/decrypting sensitive fields in settings.
+ */
+export interface IEncryptionOptions {
+    encrypt: (plaintext: string) => string;
+    decrypt: (ciphertext: string) => Promise<string>;
+}
+/**
+ * Options for configuring a Sprinkle instance.
+ */
+export interface ISprinkleOptions {
+    encryption?: IEncryptionOptions;
+}
+/**
+ * Metadata for a profile.
+ */
+export interface IProfileMeta {
+    name: string;
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Current profile information including ID.
+ */
+export interface ICurrentProfile extends IProfileMeta {
+    id: string;
+}
+/**
+ * Profile entry as returned by scanProfiles().
+ */
+export interface IProfileEntry {
+    id: string;
+    meta: IProfileMeta;
+}
+/**
+ * Result of the TxDialog interaction.
+ */
+export interface TxDialogResult {
+    action: "submitted" | "signed" | "cancelled";
+    txId?: string;
+    tx: Core.Transaction;
+}
+/**
+ * Options for TxDialog.
+ */
+export interface TxDialogOptions {
+    beforeSign?: () => Promise<void>;
+}
+/**
+ * Error thrown when user cancels a prompt via Escape key.
+ */
+export declare class UserCancelledError extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/Sprinkle/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/Sprinkle/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,GAAE,MAAuC;CAI7D"}

package/dist/types/Sprinkle/wallet.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Wallet and provider setup utilities.
+ * Functions for creating providers, wallets, and Blaze instances.
+ */
+import { type Provider } from "@blaze-cardano/query";
+import { Blaze, type Wallet } from "@blaze-cardano/sdk";
+import { type TExact } from "./types.js";
+import { NetworkSchema, ProviderSettingsSchema, WalletSettingsSchema } from "./schemas.js";
+/**
+ * Creates a blockchain data provider based on settings.
+ */
+export declare function GetProvider(network: TExact<typeof NetworkSchema>, settings: TExact<typeof ProviderSettingsSchema>): Promise<Provider>;
+/**
+ * Creates a wallet instance based on settings.
+ */
+export declare function GetWallet(settings: TExact<typeof WalletSettingsSchema>, provider: Provider): Promise<Wallet>;
+/**
+ * Creates a Blaze instance with provider and wallet.
+ */
+export declare function GetBlaze(network: TExact<typeof NetworkSchema>, providerSettings: TExact<typeof ProviderSettingsSchema>, walletSettings: TExact<typeof WalletSettingsSchema>): Promise<Blaze<Provider, Wallet>>;
+/**
+ * Generates a new wallet from a BIP39 mnemonic phrase.
+ * Displays the 24-word recovery phrase and requires user confirmation.
+ * @returns The Bip32PrivateKey hex string for storage
+ */
+export declare function generateWalletFromMnemonic(): Promise<string>;
+//# sourceMappingURL=wallet.d.ts.map

package/dist/types/Sprinkle/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/Sprinkle/wallet.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,KAAK,EAIL,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAsB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,aAAa,CAAC,EACrC,QAAQ,EAAE,MAAM,CAAC,OAAO,sBAAsB,CAAC,GAC9C,OAAO,CAAC,QAAQ,CAAC,CAsBnB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,CAAC,OAAO,oBAAoB,CAAC,EAC7C,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,CAAC,OAAO,aAAa,CAAC,EACrC,gBAAgB,EAAE,MAAM,CAAC,OAAO,sBAAsB,CAAC,EACvD,cAAc,EAAE,MAAM,CAAC,OAAO,oBAAoB,CAAC,GAClD,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAIlC;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC,CAqClE"}