@talismn/crypto 0.3.4 → 1.0.0

package/dist/index.d.mts

@@ -1,30 +1,33 @@
-import * as _noble_hashes_utils from '@noble/hashes/utils';
-export { ed25519 } from '@noble/curves/ed25519';
-export { base58, base64, hex, utf8 } from '@scure/base';
-
+import { ed25519 } from "@noble/curves/ed25519.js";
+import { base58, base64, hex, utf8 } from "@scure/base";
+//#region src/types/index.d.ts
 type KeypairCurve = "ecdsa" | "ed25519" | "sr25519" | "ethereum" | "bitcoin-ed25519" | "bitcoin-ecdsa" | "solana";
 type AddressEncoding = "ss58" | "ethereum" | "bech32m" | "bech32" | "base58check" | "base58solana";
 type Keypair = {
-    type: KeypairCurve;
-    secretKey: Uint8Array;
-    publicKey: Uint8Array;
-    address: string;
+  type: KeypairCurve;
+  secretKey: Uint8Array;
+  publicKey: Uint8Array;
+  address: string;
 };
 type AccountPlatform = "ethereum" | "polkadot" | "bitcoin" | "solana";
-
-type EncodeAddressOptions$1 = {
-    ss58Prefix?: number;
-};
-declare const addressFromPublicKey: (publicKey: Uint8Array, encoding: AddressEncoding, options?: EncodeAddressOptions$1) => string;
-
+//#endregion
+//#region src/address/addressFromPublicKey.d.ts
 type EncodeAddressOptions = {
-    ss58Format?: number | undefined;
+  ss58Prefix?: number;
+};
+declare const addressFromPublicKey: (publicKey: Uint8Array, encoding: AddressEncoding, options?: EncodeAddressOptions) => string;
+//#endregion
+//#region src/address/encodeAnyAddress.d.ts
+type EncodeAddressOptions$1 = {
+  ss58Format?: number | undefined;
 };
-declare const encodeAnyAddress: (address: string, options?: EncodeAddressOptions) => string;
-
+declare const encodeAnyAddress: (address: string, options?: EncodeAddressOptions$1) => string;
+//#endregion
+//#region src/address/encoding/addressEncodingFromCurve.d.ts
 /** NOTE: Try not to use this too much, it will need to change */
 declare const addressEncodingFromCurve: (curve: KeypairCurve) => AddressEncoding;
-
+//#endregion
+//#region src/address/encoding/bitcoin.d.ts
 declare const isBitcoinAddress: (address: string) => boolean;
 declare function isBech32mAddress(address: string): boolean;
 declare function isBech32Address(address: string): boolean;
@@ -36,9 +39,9 @@ declare function isBase58CheckAddress(address: string): boolean;
  * @throws {TypeError} If the address uses the wrong encoding.
  */
 declare function fromBech32m(address: string): {
-    version: number;
-    prefix: string;
-    data: Uint8Array<ArrayBuffer>;
+  version: number;
+  prefix: string;
+  data: Uint8Array<ArrayBuffer>;
 };
 /**
  * Converts a Bech32 encoded address to its corresponding data representation.
@@ -47,9 +50,9 @@ declare function fromBech32m(address: string): {
  * @throws {TypeError} If the address uses the wrong encoding.
  */
 declare function fromBech32(address: string): {
-    version: number;
-    prefix: string;
-    data: Uint8Array<ArrayBuffer>;
+  version: number;
+  prefix: string;
+  data: Uint8Array<ArrayBuffer>;
 };
 /**
  * Decodes a base58check encoded Bitcoin address and returns the version and hash.
@@ -59,41 +62,60 @@ declare function fromBech32(address: string): {
  * @throws {TypeError} If the address is too short or too long.
  */
 declare function fromBase58Check(address: string): {
-    version: number;
-    hash: Uint8Array<ArrayBuffer>;
+  version: number;
+  hash: Uint8Array<ArrayBuffer>;
 };
-
+//#endregion
+//#region src/address/encoding/detectAddressEncoding.d.ts
 declare const detectAddressEncoding: (address: string) => AddressEncoding;
-
+//#endregion
+//#region src/address/encoding/ethereum.d.ts
 /**
  * Encodes a public key using H160 encoding with Ethereum checksum.
+ * Accepts both uncompressed (65 bytes) and compressed (33 bytes) public keys -
+ * polkadot-js keystores store the compressed form as the account address.
  */
 declare const encodeAddressEthereum: (publicKey: Uint8Array) => `0x${string}`;
 declare const checksumEthereumAddress: (address: string) => `0x${string}`;
 declare function isEthereumAddress(address: string): address is `0x${string}`;
-
+//#endregion
+//#region src/address/encoding/solana.d.ts
 declare const encodeAddressSolana: (publicKey: Uint8Array) => string;
 declare function isSolanaAddress(address: string): boolean;
-
-declare const decodeSs58Address: (addressStr: string) => [publicKey: Uint8Array, prefix: number];
+/**
+ * Whether the address is a valid ed25519 public key (on-curve).
+ *
+ * Program-derived addresses (PDAs) are off-curve by construction: no private key can exist
+ * for them, so a regular wallet cannot recover tokens sent to an account they own.
+ */
+declare function isOnCurveSolanaAddress(address: string): boolean;
+//#endregion
+//#region src/address/encoding/ss58.d.ts
+declare const decodeSs58Address: (addressStr: string, ignoreChecksum?: boolean) => [publicKey: Uint8Array, prefix: number];
 declare const encodeAddressSs58: (publicKey: Uint8Array | string, prefix?: number) => string;
 declare function isSs58Address(address: string): boolean;
-
+//#endregion
+//#region src/address/isAddressEqual.d.ts
 declare const isAddressEqual: (address1: string, address2: string) => boolean;
-
+//#endregion
+//#region src/address/isAddressValid.d.ts
 declare const isAddressValid: (address: string) => boolean;
-
+//#endregion
+//#region src/address/normalizeAddress.d.ts
 declare const normalizeAddress: (address: string) => string;
-
-declare const getPublicKeySolana: (secretKey: Uint8Array) => Uint8Array<ArrayBufferLike>;
-
+//#endregion
+//#region src/derivation/deriveSolana.d.ts
+declare const getPublicKeySolana: (secretKey: Uint8Array) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
+//#endregion
+//#region src/derivation/utils.d.ts
 declare const deriveKeypair: (seed: Uint8Array, derivationPath: string, curve: KeypairCurve) => Keypair;
 declare const getPublicKeyFromSecret: (secretKey: Uint8Array, curve: KeypairCurve) => Uint8Array;
 declare const addressFromMnemonic: (mnemonic: string, derivationPath: string, curve: KeypairCurve) => Promise<string>;
 declare const removeHexPrefix: (secretKey: string) => string;
 declare const parseSecretKey: (secretKey: string, platform: AccountPlatform) => Uint8Array<ArrayBufferLike>;
 declare const isValidDerivationPath: (derivationPath: string, curve: KeypairCurve) => Promise<boolean>;
-
+//#endregion
+//#region src/encryption/encryptKemAead.d.ts
 /**
  * Encrypts plaintext using ML-KEM-768 + XChaCha20-Poly1305 (KEM-AEAD).
  *
@@ -104,19 +126,44 @@ declare const isValidDerivationPath: (derivationPath: string, curve: KeypairCurv
  * @param publicKey ML-KEM-768 encapsulation key bytes
  * @param plaintext Data to encrypt (typically a signed extrinsic)
  */
-declare const encryptKemAead: (keyHash: Uint8Array, publicKey: Uint8Array, plaintext: Uint8Array) => Promise<Uint8Array<ArrayBufferLike>>;
-
+declare const encryptKemAead: (keyHash: Uint8Array, publicKey: Uint8Array, plaintext: Uint8Array) => Promise<Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>>;
+//#endregion
+//#region src/hashing/index.d.ts
 declare const blake3: {
-    (msg: _noble_hashes_utils.Input, opts?: Object | undefined): Uint8Array;
-    outputLen: number;
-    blockLen: number;
-    create(opts?: Object | undefined): _noble_hashes_utils.HashXOF<_noble_hashes_utils.HashXOF<_noble_hashes_utils.HashXOF<any>>>;
+  outputLen: number;
+  blockLen: number;
+  canXOF: boolean;
+} & import("@noble/hashes/utils.js").HashInfo & {
+  (msg: import("@noble/hashes/utils.js").TArg<Uint8Array>, opts?: import("@noble/hashes/utils.js").TArg<import("@noble/hashes/blake3.js").Blake3Opts> | undefined): import("@noble/hashes/utils.js").TRet<Uint8Array>;
+  create(opts?: import("@noble/hashes/blake3.js").Blake3Opts | undefined): import("@noble/hashes/blake3.js")._BLAKE3;
+} & ((msg: import("@noble/hashes/utils.js").TArg<import("@noble/hashes/utils.js").TArg<Uint8Array<ArrayBufferLike>>>, opts?: import("@noble/hashes/utils.js").TArg<import("@noble/hashes/utils.js").TArg<import("@noble/hashes/blake3.js").Blake3Opts> | undefined>) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>) & {
+  oid?: import("@noble/hashes/utils.js").TRet<Uint8Array>;
+  outputLen: number;
+  blockLen: number;
+  canXOF: boolean;
+  create: (opts?: import("@noble/hashes/blake3.js").Blake3Opts | undefined) => import("@noble/hashes/blake3.js")._BLAKE3;
 };
-declare const blake2b256: (msg: Uint8Array) => Uint8Array<ArrayBufferLike>;
-declare const blake2b512: (msg: Uint8Array) => Uint8Array<ArrayBufferLike>;
+declare const blake2b256: (msg: Uint8Array) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
+declare const blake2b512: (msg: Uint8Array) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
 declare const getSafeHash: (bytes: Uint8Array) => string;
-
-declare const mnemonicToEntropy: (mnemonic: string) => Uint8Array<ArrayBufferLike>;
+//#endregion
+//#region src/keystore/index.d.ts
+type PjsKeystoreEncoding = {
+  content: string[];
+  type: string[];
+  version: string;
+};
+type PjsKeystore = {
+  encoded: string;
+  encoding: PjsKeystoreEncoding;
+};
+/** Decrypts a polkadot-js encrypted keystore (`jsonDecrypt` equivalent) */
+declare const decryptPjsKeystore: ({ encoded, encoding }: PjsKeystore, password: string) => Uint8Array;
+/** Encrypts data as a polkadot-js keystore (`jsonEncrypt` equivalent, always scrypt + v3) */
+declare const encryptPjsKeystore: (data: Uint8Array, contentType: string[], password: string) => PjsKeystore;
+//#endregion
+//#region src/mnemonic/index.d.ts
+declare const mnemonicToEntropy: (mnemonic: string) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
 declare const entropyToMnemonic: (entropy: Uint8Array) => string;
 declare const entropyToSeed: (entropy: Uint8Array, curve: KeypairCurve, password?: string) => Promise<Uint8Array<ArrayBuffer>>;
 declare const isValidMnemonic: (mnemonic: string) => boolean;
@@ -124,11 +171,30 @@ declare const generateMnemonic: (words: 12 | 24) => string;
 declare const DEV_MNEMONIC_POLKADOT = "bottom drive obey lake curtain smoke basket hold race lonely fit walk";
 declare const DEV_MNEMONIC_ETHEREUM = "test test test test test test test test test test test junk";
 declare const getDevSeed: (curve: KeypairCurve) => Promise<Uint8Array<ArrayBufferLike>>;
-
+//#endregion
+//#region src/platform/index.d.ts
 declare const getAccountPlatformFromCurve: (curve: KeypairCurve) => AccountPlatform;
 declare const getAccountPlatformFromEncoding: (encoding: AddressEncoding) => AccountPlatform;
 declare const getAccountPlatformFromAddress: (address: string) => AccountPlatform;
-
+//#endregion
+//#region src/signing/index.d.ts
+/**
+ * Signs a substrate payload with the given curve.
+ *
+ * Output is byte-compatible with polkadot-js `KeyringPair.sign` (without type prefix):
+ * - sr25519/ed25519: 64-byte signature over the raw message
+ * - ecdsa: 65-byte recoverable signature (r||s||v) over blake2b-256(message)
+ * - ethereum: 65-byte recoverable signature (r||s||v) over keccak-256(message)
+ *
+ * Note: callers are responsible for the substrate >256-byte rule (hash the payload
+ * with blake2b-256 before signing) — this matches where polkadot-js applies it.
+ */
+declare const signSubstrate: (curve: KeypairCurve, secretKey: Uint8Array, message: Uint8Array) => Uint8Array;
+/** MultiSignature enum variant index per signature scheme, used to type-prefix signatures */
+declare const SIGNATURE_TYPE_PREFIX: Partial<Record<KeypairCurve, number>>;
+//#endregion
+//#region src/utils/pbkdf2.d.ts
 declare const pbkdf2: (hash: "SHA-256" | "SHA-512", entropy: Uint8Array, salt: Uint8Array, iterations: number, outputLenBytes: number) => Promise<Uint8Array<ArrayBuffer>>;
-
-export { type AccountPlatform, type AddressEncoding, DEV_MNEMONIC_ETHEREUM, DEV_MNEMONIC_POLKADOT, type EncodeAddressOptions$1 as EncodeAddressOptions, type Keypair, type KeypairCurve, addressEncodingFromCurve, addressFromMnemonic, addressFromPublicKey, blake2b256, blake2b512, blake3, checksumEthereumAddress, decodeSs58Address, deriveKeypair, detectAddressEncoding, encodeAddressEthereum, encodeAddressSolana, encodeAddressSs58, encodeAnyAddress, encryptKemAead, entropyToMnemonic, entropyToSeed, fromBase58Check, fromBech32, fromBech32m, generateMnemonic, getAccountPlatformFromAddress, getAccountPlatformFromCurve, getAccountPlatformFromEncoding, getDevSeed, getPublicKeyFromSecret, getPublicKeySolana, getSafeHash, isAddressEqual, isAddressValid, isBase58CheckAddress, isBech32Address, isBech32mAddress, isBitcoinAddress, isEthereumAddress, isSolanaAddress, isSs58Address, isValidDerivationPath, isValidMnemonic, mnemonicToEntropy, normalizeAddress, parseSecretKey, pbkdf2, removeHexPrefix };
+//#endregion
+export { AccountPlatform, AddressEncoding, DEV_MNEMONIC_ETHEREUM, DEV_MNEMONIC_POLKADOT, EncodeAddressOptions, Keypair, KeypairCurve, PjsKeystore, PjsKeystoreEncoding, SIGNATURE_TYPE_PREFIX, addressEncodingFromCurve, addressFromMnemonic, addressFromPublicKey, base58, base64, blake2b256, blake2b512, blake3, checksumEthereumAddress, decodeSs58Address, decryptPjsKeystore, deriveKeypair, detectAddressEncoding, ed25519, encodeAddressEthereum, encodeAddressSolana, encodeAddressSs58, encodeAnyAddress, encryptKemAead, encryptPjsKeystore, entropyToMnemonic, entropyToSeed, fromBase58Check, fromBech32, fromBech32m, generateMnemonic, getAccountPlatformFromAddress, getAccountPlatformFromCurve, getAccountPlatformFromEncoding, getDevSeed, getPublicKeyFromSecret, getPublicKeySolana, getSafeHash, hex, isAddressEqual, isAddressValid, isBase58CheckAddress, isBech32Address, isBech32mAddress, isBitcoinAddress, isEthereumAddress, isOnCurveSolanaAddress, isSolanaAddress, isSs58Address, isValidDerivationPath, isValidMnemonic, mnemonicToEntropy, normalizeAddress, parseSecretKey, pbkdf2, removeHexPrefix, signSubstrate, utf8 };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/index.ts","../src/address/addressFromPublicKey.ts","../src/address/encodeAnyAddress.ts","../src/address/encoding/addressEncodingFromCurve.ts","../src/address/encoding/bitcoin.ts","../src/address/encoding/detectAddressEncoding.ts","../src/address/encoding/ethereum.ts","../src/address/encoding/solana.ts","../src/address/encoding/ss58.ts","../src/address/isAddressEqual.ts","../src/address/isAddressValid.ts","../src/address/normalizeAddress.ts","../src/derivation/deriveSolana.ts","../src/derivation/utils.ts","../src/encryption/encryptKemAead.ts","../src/hashing/index.ts","../src/keystore/index.ts","../src/mnemonic/index.ts","../src/platform/index.ts","../src/signing/index.ts","../src/utils/pbkdf2.ts"],"mappings":";;;KAeY;KAcA;KAQA;EACV,MAAM;EACN,WAAW;EACX,WAAW;EACX;;KAGU;;;KCzCA;EACV;;cAGW,uBAAoB,WACpB,YAAU,UACX,iBAAe,UACf;;;KCPP;EACH;;cAGW,mBAAgB,iBAAmB,UAAY;;;;cCJ/C,2BAAwB,OAAW,iBAAe;;;cCAlD,mBAAgB;iBAGb,iBAAiB;iBASjB,gBAAgB;iBAShB,qBAAqB;;;;;;;iBAerB,YAAY;;;QAAZ,WAAA;;;;;;;;iBAkBA,WAAW;;;QAAX,WAAA;;;;;;;;;iBAmBA,gBAAgB;;QAAhB,WAAA;;;;cC1DH,wBAAqB,oBAAsB;;;;;;;;cCT3C,wBAAqB,WAAe;cAoBpC,0BAAuB;iBAapB,kBAAkB,kBAAkB;;;cCvCvC,sBAAmB,WAAe;iBAK/B,gBAAgB;;;;;;;iBAehB,uBAAuB;;;cCY1B,oBAAiB,oBACV,8BAGhB,WAAW,YAAY;cAoBd,oBAAiB,WAAe,qBAAmB;iBAKhD,cAAc;;;cC9DjB,iBAAc,kBAAoB;;;cCAlC,iBAAc;;;cCQd,mBAAgB;;;cC6ChB,qBAAkB,WAAe,eAAU,WAAA,mBAAA,WAAA;;;cC7C3C,gBAAa,MAAU,YAAU,wBAAwB,OAAS,iBAAA;cAkBlE,yBAAsB,WAAe,YAAU,OAAS,iBAAe;cAkBvE,sBAAmB,kBACd,wBACM,OACf,iBAAY;cAQR,kBAAe;cAKf,iBAAc,mBAAqB,UAAY,oBAAe,WAAA;cA+B9D,wBAAqB,wBAAgC,OAAS,iBAAY;;;;;;;;;;;;;cC/E1E,iBAAc,SAChB,YAAU,WACR,YAAU,WACV,eAAU,QAAA,WAAA,mBAAA,WAAA;;;cCbV;;;;;;;;;;;;;;cAEA,aAAU,KAAS,eAAU,WAAA,mBAAA,WAAA;cAC7B,aAAU,KAAS,eAAU,WAAA,mBAAA,WAAA;cAE7B,cAAW,OAAW;;;KCuBvB;EACV;EACA;EACA;;KAGU;EACV;EACA,UAAU;;;cAoBC,uBAAkB,SAAA,YACN,aAAW,qBAEjC;;cAqCU,qBAAkB,MACvB,YAAU,uBACK,qBAEpB;;;cC7FU,oBAAiB,qBAAoB,WAAA,mBAAA,WAAA;cAIrC,oBAAiB,SAAa;cA+C9B,gBAAa,SACf,YAAU,OACZ,cAAY,sBACF,QAAA,WAAA;cAYN,kBAAe;cAIf,mBAAgB;cAUhB;cAIA;cAKA,aAAU,OAAiB,iBAAY,QAAA,WAAA;;;cCjGvC,8BAA2B,OAAW,iBAAe;cAgBrD,iCAA8B,UAAc,oBAAkB;cAe9D,gCAA6B,oBAAsB;;;;;;;;;;;;;;cCPnD,gBAAa,OACjB,cAAY,WACR,YAAU,SACZ,eACR;;cAsBU,uBAAuB,QAAQ,OAAO;;;cCrDtC,SAAM,6BACU,SAClB,YAAU,MACb,YAAU,oBACE,2BACI,QAAA,WAAA"}

package/dist/index.d.ts

@@ -1,30 +1,33 @@
-import * as _noble_hashes_utils from '@noble/hashes/utils';
-export { ed25519 } from '@noble/curves/ed25519';
-export { base58, base64, hex, utf8 } from '@scure/base';
-
+import { ed25519 } from "@noble/curves/ed25519.js";
+import { base58, base64, hex, utf8 } from "@scure/base";
+//#region src/types/index.d.ts
 type KeypairCurve = "ecdsa" | "ed25519" | "sr25519" | "ethereum" | "bitcoin-ed25519" | "bitcoin-ecdsa" | "solana";
 type AddressEncoding = "ss58" | "ethereum" | "bech32m" | "bech32" | "base58check" | "base58solana";
 type Keypair = {
-    type: KeypairCurve;
-    secretKey: Uint8Array;
-    publicKey: Uint8Array;
-    address: string;
+  type: KeypairCurve;
+  secretKey: Uint8Array;
+  publicKey: Uint8Array;
+  address: string;
 };
 type AccountPlatform = "ethereum" | "polkadot" | "bitcoin" | "solana";
-
-type EncodeAddressOptions$1 = {
-    ss58Prefix?: number;
-};
-declare const addressFromPublicKey: (publicKey: Uint8Array, encoding: AddressEncoding, options?: EncodeAddressOptions$1) => string;
-
+//#endregion
+//#region src/address/addressFromPublicKey.d.ts
 type EncodeAddressOptions = {
-    ss58Format?: number | undefined;
+  ss58Prefix?: number;
+};
+declare const addressFromPublicKey: (publicKey: Uint8Array, encoding: AddressEncoding, options?: EncodeAddressOptions) => string;
+//#endregion
+//#region src/address/encodeAnyAddress.d.ts
+type EncodeAddressOptions$1 = {
+  ss58Format?: number | undefined;
 };
-declare const encodeAnyAddress: (address: string, options?: EncodeAddressOptions) => string;
-
+declare const encodeAnyAddress: (address: string, options?: EncodeAddressOptions$1) => string;
+//#endregion
+//#region src/address/encoding/addressEncodingFromCurve.d.ts
 /** NOTE: Try not to use this too much, it will need to change */
 declare const addressEncodingFromCurve: (curve: KeypairCurve) => AddressEncoding;
-
+//#endregion
+//#region src/address/encoding/bitcoin.d.ts
 declare const isBitcoinAddress: (address: string) => boolean;
 declare function isBech32mAddress(address: string): boolean;
 declare function isBech32Address(address: string): boolean;
@@ -36,9 +39,9 @@ declare function isBase58CheckAddress(address: string): boolean;
  * @throws {TypeError} If the address uses the wrong encoding.
  */
 declare function fromBech32m(address: string): {
-    version: number;
-    prefix: string;
-    data: Uint8Array<ArrayBuffer>;
+  version: number;
+  prefix: string;
+  data: Uint8Array<ArrayBuffer>;
 };
 /**
  * Converts a Bech32 encoded address to its corresponding data representation.
@@ -47,9 +50,9 @@ declare function fromBech32m(address: string): {
  * @throws {TypeError} If the address uses the wrong encoding.
  */
 declare function fromBech32(address: string): {
-    version: number;
-    prefix: string;
-    data: Uint8Array<ArrayBuffer>;
+  version: number;
+  prefix: string;
+  data: Uint8Array<ArrayBuffer>;
 };
 /**
  * Decodes a base58check encoded Bitcoin address and returns the version and hash.
@@ -59,41 +62,60 @@ declare function fromBech32(address: string): {
  * @throws {TypeError} If the address is too short or too long.
  */
 declare function fromBase58Check(address: string): {
-    version: number;
-    hash: Uint8Array<ArrayBuffer>;
+  version: number;
+  hash: Uint8Array<ArrayBuffer>;
 };
-
+//#endregion
+//#region src/address/encoding/detectAddressEncoding.d.ts
 declare const detectAddressEncoding: (address: string) => AddressEncoding;
-
+//#endregion
+//#region src/address/encoding/ethereum.d.ts
 /**
  * Encodes a public key using H160 encoding with Ethereum checksum.
+ * Accepts both uncompressed (65 bytes) and compressed (33 bytes) public keys -
+ * polkadot-js keystores store the compressed form as the account address.
  */
 declare const encodeAddressEthereum: (publicKey: Uint8Array) => `0x${string}`;
 declare const checksumEthereumAddress: (address: string) => `0x${string}`;
 declare function isEthereumAddress(address: string): address is `0x${string}`;
-
+//#endregion
+//#region src/address/encoding/solana.d.ts
 declare const encodeAddressSolana: (publicKey: Uint8Array) => string;
 declare function isSolanaAddress(address: string): boolean;
-
-declare const decodeSs58Address: (addressStr: string) => [publicKey: Uint8Array, prefix: number];
+/**
+ * Whether the address is a valid ed25519 public key (on-curve).
+ *
+ * Program-derived addresses (PDAs) are off-curve by construction: no private key can exist
+ * for them, so a regular wallet cannot recover tokens sent to an account they own.
+ */
+declare function isOnCurveSolanaAddress(address: string): boolean;
+//#endregion
+//#region src/address/encoding/ss58.d.ts
+declare const decodeSs58Address: (addressStr: string, ignoreChecksum?: boolean) => [publicKey: Uint8Array, prefix: number];
 declare const encodeAddressSs58: (publicKey: Uint8Array | string, prefix?: number) => string;
 declare function isSs58Address(address: string): boolean;
-
+//#endregion
+//#region src/address/isAddressEqual.d.ts
 declare const isAddressEqual: (address1: string, address2: string) => boolean;
-
+//#endregion
+//#region src/address/isAddressValid.d.ts
 declare const isAddressValid: (address: string) => boolean;
-
+//#endregion
+//#region src/address/normalizeAddress.d.ts
 declare const normalizeAddress: (address: string) => string;
-
-declare const getPublicKeySolana: (secretKey: Uint8Array) => Uint8Array<ArrayBufferLike>;
-
+//#endregion
+//#region src/derivation/deriveSolana.d.ts
+declare const getPublicKeySolana: (secretKey: Uint8Array) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
+//#endregion
+//#region src/derivation/utils.d.ts
 declare const deriveKeypair: (seed: Uint8Array, derivationPath: string, curve: KeypairCurve) => Keypair;
 declare const getPublicKeyFromSecret: (secretKey: Uint8Array, curve: KeypairCurve) => Uint8Array;
 declare const addressFromMnemonic: (mnemonic: string, derivationPath: string, curve: KeypairCurve) => Promise<string>;
 declare const removeHexPrefix: (secretKey: string) => string;
 declare const parseSecretKey: (secretKey: string, platform: AccountPlatform) => Uint8Array<ArrayBufferLike>;
 declare const isValidDerivationPath: (derivationPath: string, curve: KeypairCurve) => Promise<boolean>;
-
+//#endregion
+//#region src/encryption/encryptKemAead.d.ts
 /**
  * Encrypts plaintext using ML-KEM-768 + XChaCha20-Poly1305 (KEM-AEAD).
  *
@@ -104,19 +126,44 @@ declare const isValidDerivationPath: (derivationPath: string, curve: KeypairCurv
  * @param publicKey ML-KEM-768 encapsulation key bytes
  * @param plaintext Data to encrypt (typically a signed extrinsic)
  */
-declare const encryptKemAead: (keyHash: Uint8Array, publicKey: Uint8Array, plaintext: Uint8Array) => Promise<Uint8Array<ArrayBufferLike>>;
-
+declare const encryptKemAead: (keyHash: Uint8Array, publicKey: Uint8Array, plaintext: Uint8Array) => Promise<Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>>;
+//#endregion
+//#region src/hashing/index.d.ts
 declare const blake3: {
-    (msg: _noble_hashes_utils.Input, opts?: Object | undefined): Uint8Array;
-    outputLen: number;
-    blockLen: number;
-    create(opts?: Object | undefined): _noble_hashes_utils.HashXOF<_noble_hashes_utils.HashXOF<_noble_hashes_utils.HashXOF<any>>>;
+  outputLen: number;
+  blockLen: number;
+  canXOF: boolean;
+} & import("@noble/hashes/utils.js").HashInfo & {
+  (msg: import("@noble/hashes/utils.js").TArg<Uint8Array>, opts?: import("@noble/hashes/utils.js").TArg<import("@noble/hashes/blake3.js").Blake3Opts> | undefined): import("@noble/hashes/utils.js").TRet<Uint8Array>;
+  create(opts?: import("@noble/hashes/blake3.js").Blake3Opts | undefined): import("@noble/hashes/blake3.js")._BLAKE3;
+} & ((msg: import("@noble/hashes/utils.js").TArg<import("@noble/hashes/utils.js").TArg<Uint8Array<ArrayBufferLike>>>, opts?: import("@noble/hashes/utils.js").TArg<import("@noble/hashes/utils.js").TArg<import("@noble/hashes/blake3.js").Blake3Opts> | undefined>) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>) & {
+  oid?: import("@noble/hashes/utils.js").TRet<Uint8Array>;
+  outputLen: number;
+  blockLen: number;
+  canXOF: boolean;
+  create: (opts?: import("@noble/hashes/blake3.js").Blake3Opts | undefined) => import("@noble/hashes/blake3.js")._BLAKE3;
 };
-declare const blake2b256: (msg: Uint8Array) => Uint8Array<ArrayBufferLike>;
-declare const blake2b512: (msg: Uint8Array) => Uint8Array<ArrayBufferLike>;
+declare const blake2b256: (msg: Uint8Array) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
+declare const blake2b512: (msg: Uint8Array) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
 declare const getSafeHash: (bytes: Uint8Array) => string;
-
-declare const mnemonicToEntropy: (mnemonic: string) => Uint8Array<ArrayBufferLike>;
+//#endregion
+//#region src/keystore/index.d.ts
+type PjsKeystoreEncoding = {
+  content: string[];
+  type: string[];
+  version: string;
+};
+type PjsKeystore = {
+  encoded: string;
+  encoding: PjsKeystoreEncoding;
+};
+/** Decrypts a polkadot-js encrypted keystore (`jsonDecrypt` equivalent) */
+declare const decryptPjsKeystore: ({ encoded, encoding }: PjsKeystore, password: string) => Uint8Array;
+/** Encrypts data as a polkadot-js keystore (`jsonEncrypt` equivalent, always scrypt + v3) */
+declare const encryptPjsKeystore: (data: Uint8Array, contentType: string[], password: string) => PjsKeystore;
+//#endregion
+//#region src/mnemonic/index.d.ts
+declare const mnemonicToEntropy: (mnemonic: string) => Uint8Array<ArrayBufferLike> & Uint8Array<ArrayBuffer>;
 declare const entropyToMnemonic: (entropy: Uint8Array) => string;
 declare const entropyToSeed: (entropy: Uint8Array, curve: KeypairCurve, password?: string) => Promise<Uint8Array<ArrayBuffer>>;
 declare const isValidMnemonic: (mnemonic: string) => boolean;
@@ -124,11 +171,30 @@ declare const generateMnemonic: (words: 12 | 24) => string;
 declare const DEV_MNEMONIC_POLKADOT = "bottom drive obey lake curtain smoke basket hold race lonely fit walk";
 declare const DEV_MNEMONIC_ETHEREUM = "test test test test test test test test test test test junk";
 declare const getDevSeed: (curve: KeypairCurve) => Promise<Uint8Array<ArrayBufferLike>>;
-
+//#endregion
+//#region src/platform/index.d.ts
 declare const getAccountPlatformFromCurve: (curve: KeypairCurve) => AccountPlatform;
 declare const getAccountPlatformFromEncoding: (encoding: AddressEncoding) => AccountPlatform;
 declare const getAccountPlatformFromAddress: (address: string) => AccountPlatform;
-
+//#endregion
+//#region src/signing/index.d.ts
+/**
+ * Signs a substrate payload with the given curve.
+ *
+ * Output is byte-compatible with polkadot-js `KeyringPair.sign` (without type prefix):
+ * - sr25519/ed25519: 64-byte signature over the raw message
+ * - ecdsa: 65-byte recoverable signature (r||s||v) over blake2b-256(message)
+ * - ethereum: 65-byte recoverable signature (r||s||v) over keccak-256(message)
+ *
+ * Note: callers are responsible for the substrate >256-byte rule (hash the payload
+ * with blake2b-256 before signing) — this matches where polkadot-js applies it.
+ */
+declare const signSubstrate: (curve: KeypairCurve, secretKey: Uint8Array, message: Uint8Array) => Uint8Array;
+/** MultiSignature enum variant index per signature scheme, used to type-prefix signatures */
+declare const SIGNATURE_TYPE_PREFIX: Partial<Record<KeypairCurve, number>>;
+//#endregion
+//#region src/utils/pbkdf2.d.ts
 declare const pbkdf2: (hash: "SHA-256" | "SHA-512", entropy: Uint8Array, salt: Uint8Array, iterations: number, outputLenBytes: number) => Promise<Uint8Array<ArrayBuffer>>;
-
-export { type AccountPlatform, type AddressEncoding, DEV_MNEMONIC_ETHEREUM, DEV_MNEMONIC_POLKADOT, type EncodeAddressOptions$1 as EncodeAddressOptions, type Keypair, type KeypairCurve, addressEncodingFromCurve, addressFromMnemonic, addressFromPublicKey, blake2b256, blake2b512, blake3, checksumEthereumAddress, decodeSs58Address, deriveKeypair, detectAddressEncoding, encodeAddressEthereum, encodeAddressSolana, encodeAddressSs58, encodeAnyAddress, encryptKemAead, entropyToMnemonic, entropyToSeed, fromBase58Check, fromBech32, fromBech32m, generateMnemonic, getAccountPlatformFromAddress, getAccountPlatformFromCurve, getAccountPlatformFromEncoding, getDevSeed, getPublicKeyFromSecret, getPublicKeySolana, getSafeHash, isAddressEqual, isAddressValid, isBase58CheckAddress, isBech32Address, isBech32mAddress, isBitcoinAddress, isEthereumAddress, isSolanaAddress, isSs58Address, isValidDerivationPath, isValidMnemonic, mnemonicToEntropy, normalizeAddress, parseSecretKey, pbkdf2, removeHexPrefix };
+//#endregion
+export { AccountPlatform, AddressEncoding, DEV_MNEMONIC_ETHEREUM, DEV_MNEMONIC_POLKADOT, EncodeAddressOptions, Keypair, KeypairCurve, PjsKeystore, PjsKeystoreEncoding, SIGNATURE_TYPE_PREFIX, addressEncodingFromCurve, addressFromMnemonic, addressFromPublicKey, base58, base64, blake2b256, blake2b512, blake3, checksumEthereumAddress, decodeSs58Address, decryptPjsKeystore, deriveKeypair, detectAddressEncoding, ed25519, encodeAddressEthereum, encodeAddressSolana, encodeAddressSs58, encodeAnyAddress, encryptKemAead, encryptPjsKeystore, entropyToMnemonic, entropyToSeed, fromBase58Check, fromBech32, fromBech32m, generateMnemonic, getAccountPlatformFromAddress, getAccountPlatformFromCurve, getAccountPlatformFromEncoding, getDevSeed, getPublicKeyFromSecret, getPublicKeySolana, getSafeHash, hex, isAddressEqual, isAddressValid, isBase58CheckAddress, isBech32Address, isBech32mAddress, isBitcoinAddress, isEthereumAddress, isOnCurveSolanaAddress, isSolanaAddress, isSs58Address, isValidDerivationPath, isValidMnemonic, mnemonicToEntropy, normalizeAddress, parseSecretKey, pbkdf2, removeHexPrefix, signSubstrate, utf8 };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types/index.ts","../src/address/addressFromPublicKey.ts","../src/address/encodeAnyAddress.ts","../src/address/encoding/addressEncodingFromCurve.ts","../src/address/encoding/bitcoin.ts","../src/address/encoding/detectAddressEncoding.ts","../src/address/encoding/ethereum.ts","../src/address/encoding/solana.ts","../src/address/encoding/ss58.ts","../src/address/isAddressEqual.ts","../src/address/isAddressValid.ts","../src/address/normalizeAddress.ts","../src/derivation/deriveSolana.ts","../src/derivation/utils.ts","../src/encryption/encryptKemAead.ts","../src/hashing/index.ts","../src/keystore/index.ts","../src/mnemonic/index.ts","../src/platform/index.ts","../src/signing/index.ts","../src/utils/pbkdf2.ts"],"mappings":";;;KAeY;KAcA;KAQA;EACV,MAAM;EACN,WAAW;EACX,WAAW;EACX;;KAGU;;;KCzCA;EACV;;cAGW,uBAAoB,WACpB,YAAU,UACX,iBAAe,UACf;;;KCPP;EACH;;cAGW,mBAAgB,iBAAmB,UAAY;;;;cCJ/C,2BAAwB,OAAW,iBAAe;;;cCAlD,mBAAgB;iBAGb,iBAAiB;iBASjB,gBAAgB;iBAShB,qBAAqB;;;;;;;iBAerB,YAAY;;;QAAZ,WAAA;;;;;;;;iBAkBA,WAAW;;;QAAX,WAAA;;;;;;;;;iBAmBA,gBAAgB;;QAAhB,WAAA;;;;cC1DH,wBAAqB,oBAAsB;;;;;;;;cCT3C,wBAAqB,WAAe;cAoBpC,0BAAuB;iBAapB,kBAAkB,kBAAkB;;;cCvCvC,sBAAmB,WAAe;iBAK/B,gBAAgB;;;;;;;iBAehB,uBAAuB;;;cCY1B,oBAAiB,oBACV,8BAGhB,WAAW,YAAY;cAoBd,oBAAiB,WAAe,qBAAmB;iBAKhD,cAAc;;;cC9DjB,iBAAc,kBAAoB;;;cCAlC,iBAAc;;;cCQd,mBAAgB;;;cC6ChB,qBAAkB,WAAe,eAAU,WAAA,mBAAA,WAAA;;;cC7C3C,gBAAa,MAAU,YAAU,wBAAwB,OAAS,iBAAA;cAkBlE,yBAAsB,WAAe,YAAU,OAAS,iBAAe;cAkBvE,sBAAmB,kBACd,wBACM,OACf,iBAAY;cAQR,kBAAe;cAKf,iBAAc,mBAAqB,UAAY,oBAAe,WAAA;cA+B9D,wBAAqB,wBAAgC,OAAS,iBAAY;;;;;;;;;;;;;cC/E1E,iBAAc,SAChB,YAAU,WACR,YAAU,WACV,eAAU,QAAA,WAAA,mBAAA,WAAA;;;cCbV;;;;;;;;;;;;;;cAEA,aAAU,KAAS,eAAU,WAAA,mBAAA,WAAA;cAC7B,aAAU,KAAS,eAAU,WAAA,mBAAA,WAAA;cAE7B,cAAW,OAAW;;;KCuBvB;EACV;EACA;EACA;;KAGU;EACV;EACA,UAAU;;;cAoBC,uBAAkB,SAAA,YACN,aAAW,qBAEjC;;cAqCU,qBAAkB,MACvB,YAAU,uBACK,qBAEpB;;;cC7FU,oBAAiB,qBAAoB,WAAA,mBAAA,WAAA;cAIrC,oBAAiB,SAAa;cA+C9B,gBAAa,SACf,YAAU,OACZ,cAAY,sBACF,QAAA,WAAA;cAYN,kBAAe;cAIf,mBAAgB;cAUhB;cAIA;cAKA,aAAU,OAAiB,iBAAY,QAAA,WAAA;;;cCjGvC,8BAA2B,OAAW,iBAAe;cAgBrD,iCAA8B,UAAc,oBAAkB;cAe9D,gCAA6B,oBAAsB;;;;;;;;;;;;;;cCPnD,gBAAa,OACjB,cAAY,WACR,YAAU,SACZ,eACR;;cAsBU,uBAAuB,QAAQ,OAAO;;;cCrDtC,SAAM,6BACU,SAClB,YAAU,MACb,YAAU,oBACE,2BACI,QAAA,WAAA"}