crypto-aio 0.0.2 → 0.1.0

package/dist/adapters/solana/keys.d.ts

@@ -0,0 +1,13 @@
+/** The bytes of a canonical base58 string of `length` bytes, or `null`. */
+export declare function decodeBase58(value: unknown, length: number): Uint8Array | null;
+export declare const encodeBase58: (bytes: Uint8Array) => string;
+/** A 32-byte account address (on or off the ed25519 curve: PDAs are addresses too). */
+export declare const isAddress: (value: unknown) => value is string;
+/** A 64-byte transaction signature. */
+export declare const isSignature: (value: unknown) => value is string;
+/**
+ * The address of a wallet's ed25519 public key: exactly 32 bytes that decode to a point on
+ * the curve and not of small order. Anything else (a 64-byte secret key, a 32-byte seed
+ * that is off the curve, the identity point) is refused with `INVALID_ADDRESS`.
+ */
+export declare function addressFromPublicKey(publicKey: Uint8Array): string;

package/dist/adapters/solana/keys.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSignature = exports.isAddress = exports.encodeBase58 = void 0;
+exports.decodeBase58 = decodeBase58;
+exports.addressFromPublicKey = addressFromPublicKey;
+/**
+ * Strict, SDK-free decoding of Solana keys and signatures. Only canonical
+ * base58 of exactly 32 (keys) or 64 (signatures) bytes is accepted, so the driver never
+ * relies on an SDK's leniency (`new PublicKey()` also takes numbers, arrays and BNs).
+ */
+const ed25519_1 = require("@noble/curves/ed25519");
+const base_1 = require("@scure/base");
+const error_1 = require("../../core/errors/error");
+const ALPHABET = /^[1-9A-HJ-NP-Za-km-z]+$/;
+/**
+ * The longest base58 text of `length` bytes: 44 characters for a key, 88 for a signature.
+ * base58 decoding is O(n²), so longer text is refused before it is decoded.
+ */
+const maxChars = (length) => Math.ceil((length * 8) / Math.log2(58));
+/** The bytes of a canonical base58 string of `length` bytes, or `null`. */
+function decodeBase58(value, length) {
+    if (typeof value !== 'string' || value.length === 0)
+        return null;
+    if (value.length > maxChars(length))
+        return null;
+    if (!ALPHABET.test(value))
+        return null;
+    let bytes;
+    try {
+        bytes = base_1.base58.decode(value);
+    }
+    catch {
+        return null;
+    }
+    // Canonical: exactly `length` bytes, and re-encoding gives the same text back.
+    if (bytes.length !== length || base_1.base58.encode(bytes) !== value)
+        return null;
+    return bytes;
+}
+const encodeBase58 = (bytes) => base_1.base58.encode(bytes);
+exports.encodeBase58 = encodeBase58;
+/** A 32-byte account address (on or off the ed25519 curve: PDAs are addresses too). */
+const isAddress = (value) => decodeBase58(value, 32) !== null;
+exports.isAddress = isAddress;
+/** A 64-byte transaction signature. */
+const isSignature = (value) => decodeBase58(value, 64) !== null;
+exports.isSignature = isSignature;
+/**
+ * The address of a wallet's ed25519 public key: exactly 32 bytes that decode to a point on
+ * the curve and not of small order. Anything else (a 64-byte secret key, a 32-byte seed
+ * that is off the curve, the identity point) is refused with `INVALID_ADDRESS`.
+ */
+function addressFromPublicKey(publicKey) {
+    if (!(publicKey instanceof Uint8Array) || publicKey.length !== 32) {
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'a Solana public key is exactly 32 bytes');
+    }
+    let point;
+    try {
+        point = ed25519_1.ed25519.ExtendedPoint.fromHex(publicKey);
+    }
+    catch {
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'the public key is not a point on the ed25519 curve');
+    }
+    if (point.isSmallOrder()) {
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'the public key has small order');
+    }
+    return base_1.base58.encode(publicKey);
+}
+//# sourceMappingURL=keys.js.map

package/dist/adapters/solana/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/adapters/solana/keys.ts"],"names":[],"mappings":";;;AAkBA,oCAaC;AAiBD,oDAoBC;AApED;;;;GAIG;AACH,mDAAgD;AAChD,sCAAqC;AACrC,mDAA0D;AAE1D,MAAM,QAAQ,GAAG,yBAAyB,CAAC;AAE3C;;;GAGG;AACH,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAErF,2EAA2E;AAC3E,SAAgB,YAAY,CAAC,KAAc,EAAE,MAAc;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjE,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,KAAiB,CAAC;IACtB,IAAI,CAAC;QACH,KAAK,GAAG,aAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,+EAA+E;IAC/E,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,aAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAEM,MAAM,YAAY,GAAG,CAAC,KAAiB,EAAU,EAAE,CAAC,aAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAnE,QAAA,YAAY,gBAAuD;AAEhF,uFAAuF;AAChF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC3D,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;AADtB,QAAA,SAAS,aACa;AAEnC,uCAAuC;AAChC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC7D,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC;AADtB,QAAA,WAAW,eACW;AAEnC;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,SAAqB;IACxD,IAAI,CAAC,CAAC,SAAS,YAAY,UAAU,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAClE,MAAM,IAAI,uBAAe,CACvB,iBAAiB,EACjB,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,KAAuD,CAAC;IAC5D,IAAI,CAAC;QACH,KAAK,GAAG,iBAAO,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,uBAAe,CACvB,iBAAiB,EACjB,oDAAoD,CACrD,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,uBAAe,CAAC,iBAAiB,EAAE,gCAAgC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,aAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC","sourcesContent":["/**\n * Strict, SDK-free decoding of Solana keys and signatures. Only canonical\n * base58 of exactly 32 (keys) or 64 (signatures) bytes is accepted, so the driver never\n * relies on an SDK's leniency (`new PublicKey()` also takes numbers, arrays and BNs).\n */\nimport { ed25519 } from '@noble/curves/ed25519';\nimport { base58 } from '@scure/base';\nimport { ValidationError } from '../../core/errors/error';\n\nconst ALPHABET = /^[1-9A-HJ-NP-Za-km-z]+$/;\n\n/**\n * The longest base58 text of `length` bytes: 44 characters for a key, 88 for a signature.\n * base58 decoding is O(n²), so longer text is refused before it is decoded.\n */\nconst maxChars = (length: number): number => Math.ceil((length * 8) / Math.log2(58));\n\n/** The bytes of a canonical base58 string of `length` bytes, or `null`. */\nexport function decodeBase58(value: unknown, length: number): Uint8Array | null {\n  if (typeof value !== 'string' || value.length === 0) return null;\n  if (value.length > maxChars(length)) return null;\n  if (!ALPHABET.test(value)) return null;\n  let bytes: Uint8Array;\n  try {\n    bytes = base58.decode(value);\n  } catch {\n    return null;\n  }\n  // Canonical: exactly `length` bytes, and re-encoding gives the same text back.\n  if (bytes.length !== length || base58.encode(bytes) !== value) return null;\n  return bytes;\n}\n\nexport const encodeBase58 = (bytes: Uint8Array): string => base58.encode(bytes);\n\n/** A 32-byte account address (on or off the ed25519 curve: PDAs are addresses too). */\nexport const isAddress = (value: unknown): value is string =>\n  decodeBase58(value, 32) !== null;\n\n/** A 64-byte transaction signature. */\nexport const isSignature = (value: unknown): value is string =>\n  decodeBase58(value, 64) !== null;\n\n/**\n * The address of a wallet's ed25519 public key: exactly 32 bytes that decode to a point on\n * the curve and not of small order. Anything else (a 64-byte secret key, a 32-byte seed\n * that is off the curve, the identity point) is refused with `INVALID_ADDRESS`.\n */\nexport function addressFromPublicKey(publicKey: Uint8Array): string {\n  if (!(publicKey instanceof Uint8Array) || publicKey.length !== 32) {\n    throw new ValidationError(\n      'INVALID_ADDRESS',\n      'a Solana public key is exactly 32 bytes',\n    );\n  }\n  let point: ReturnType<typeof ed25519.ExtendedPoint.fromHex>;\n  try {\n    point = ed25519.ExtendedPoint.fromHex(publicKey);\n  } catch {\n    throw new ValidationError(\n      'INVALID_ADDRESS',\n      'the public key is not a point on the ed25519 curve',\n    );\n  }\n  if (point.isSmallOrder()) {\n    throw new ValidationError('INVALID_ADDRESS', 'the public key has small order');\n  }\n  return base58.encode(publicKey);\n}\n"]}

package/dist/adapters/solana/network.d.ts

@@ -0,0 +1,24 @@
+import type { Capability } from '../../core/model/capability';
+import type { ChainInfo, NetworkInfo } from '../../core/model/chain';
+/** Every capability a Solana network has; a network may remove some. */
+export declare const SOLANA_CAPABILITIES: readonly Capability[];
+/**
+ * The highest compute-unit price a transfer signs unless the handle's `maxComputeUnitPrice`
+ * option allows more: 10,000,000 micro-lamports per compute unit. A speed's
+ * price comes from one endpoint's `getRecentPrioritizationFees` and its limit from one
+ * endpoint's simulation (up to 1,400,000 units), so this operator bound is the only one no
+ * node can raise. At the largest limit it caps a transfer's priority fee at 14,000,000
+ * lamports (0.014 SOL).
+ */
+export declare const DEFAULT_MAX_COMPUTE_UNIT_PRICE = 10000000n;
+export interface SolanaNetworkConfig {
+    /** The genesis hash every endpoint must report (`getGenesisHash`). */
+    readonly genesisHash: string;
+    readonly capabilities: ReadonlySet<Capability>;
+    /**
+     * The largest compute-unit price a transfer signs, in micro-lamports per compute unit:
+     * from 999 (the largest build variant, which a speed keeps at the bound) to 2^64 − 1.
+     */
+    readonly maxComputeUnitPrice: bigint;
+}
+export declare function solanaNetworkConfig(chain: ChainInfo, network: NetworkInfo, options?: Readonly<Record<string, unknown>>): SolanaNetworkConfig;

package/dist/adapters/solana/network.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_COMPUTE_UNIT_PRICE = exports.SOLANA_CAPABILITIES = void 0;
+exports.solanaNetworkConfig = solanaNetworkConfig;
+/**
+ * What the Solana driver needs from a network's registry entry and the handle's options,
+ * validated once when a driver is created, so inconsistent data or an unknown option fails
+ * with `CONFIG_INVALID` instead of misbehaving.
+ */
+const error_1 = require("../../core/errors/error");
+const names_1 = require("../../core/util/names");
+const fees_1 = require("./fees");
+const keys_1 = require("./keys");
+/** Every capability a Solana network has; a network may remove some. */
+exports.SOLANA_CAPABILITIES = Object.freeze([
+    'tokens',
+    'memo',
+    'block-scan',
+    'address-history',
+    'expiry',
+]);
+/**
+ * The highest compute-unit price a transfer signs unless the handle's `maxComputeUnitPrice`
+ * option allows more: 10,000,000 micro-lamports per compute unit. A speed's
+ * price comes from one endpoint's `getRecentPrioritizationFees` and its limit from one
+ * endpoint's simulation (up to 1,400,000 units), so this operator bound is the only one no
+ * node can raise. At the largest limit it caps a transfer's priority fee at 14,000,000
+ * lamports (0.014 SOL).
+ */
+exports.DEFAULT_MAX_COMPUTE_UNIT_PRICE = 10000000n;
+const U64_MAX = 2n ** 64n - 1n;
+/**
+ * The only driver option (`HandleOptions.options`) the Solana driver reads. Any other key is
+ * refused, so a typo, or another family's option such as Tron's `maxFeeLimit`, fails loudly
+ * instead of leaving the default in place.
+ */
+const OPTION_KEYS = Object.freeze(['maxComputeUnitPrice']);
+/** A price bound: a bigint of micro-lamports per compute unit that leaves room for a variant. */
+function priceBound(value, name, fail) {
+    if (typeof value !== 'bigint' || value < fees_1.MAX_PRICE_VARIANT || value > U64_MAX) {
+        fail(`${name} must be a bigint of micro-lamports per compute unit from 999 to 2^64 − 1`);
+    }
+    return value;
+}
+function solanaNetworkConfig(chain, network, options = {}) {
+    const fail = (reason) => {
+        throw new error_1.ConfigError('CONFIG_INVALID', `Solana network ${chain.id}:${network.id}: ${reason}`);
+    };
+    if (chain.model !== 'account' || chain.ordering !== 'expiry') {
+        fail('the chain must use the account model and expiry ordering');
+    }
+    if (chain.schemes.length !== 1 || chain.schemes[0] !== 'ed25519') {
+        fail(`its only scheme must be 'ed25519'`);
+    }
+    if (chain.nativeAsset.decimals !== 9)
+        fail('the native asset has 9 decimals (lamports)');
+    if ((0, keys_1.decodeBase58)(network.identity, 32) === null) {
+        fail('its identity must be the base58 genesis hash');
+    }
+    if (network.feeModel !== 'solana')
+        fail(`its fee model must be 'solana'`);
+    const { finality } = network;
+    if (finality.kind !== 'commitment' || finality.level !== 'finalized') {
+        fail(`its finality must be the 'finalized' commitment`);
+    }
+    if (network.replacement !== undefined)
+        fail('Solana has no replace or cancel');
+    const capabilities = new Set(exports.SOLANA_CAPABILITIES);
+    for (const c of network.capabilities?.add ?? [])
+        capabilities.add(c);
+    for (const c of network.capabilities?.remove ?? [])
+        capabilities.delete(c);
+    for (const c of ['replace-fee', 'cancel', 'batch-transfer']) {
+        if (capabilities.has(c))
+            fail(`the Solana driver cannot offer '${c}'`);
+    }
+    if (!capabilities.has('expiry'))
+        fail(`'expiry' is how Solana orders transactions`);
+    // The refusal lists the accepted name and shows neither the caller's key, which
+    // may be a pasted secret, nor its value.
+    for (const key of Object.keys(options)) {
+        if (!OPTION_KEYS.includes(key)) {
+            fail((0, names_1.unknownName)('option', OPTION_KEYS));
+        }
+    }
+    // The handle's option, else the network entry's own, else the default. A network value
+    // is checked even where an option overrides it.
+    const own = network.params?.maxComputeUnitPrice;
+    const networkBound = own === undefined ? undefined : priceBound(own, 'params.maxComputeUnitPrice', fail);
+    const maxComputeUnitPrice = options.maxComputeUnitPrice !== undefined
+        ? priceBound(options.maxComputeUnitPrice, 'maxComputeUnitPrice', fail)
+        : (networkBound ?? exports.DEFAULT_MAX_COMPUTE_UNIT_PRICE);
+    return { genesisHash: network.identity, capabilities, maxComputeUnitPrice };
+}
+//# sourceMappingURL=network.js.map

package/dist/adapters/solana/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../../src/adapters/solana/network.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What the Solana driver needs from a network's registry entry and the handle's options,\n * validated once when a driver is created, so inconsistent data or an unknown option fails\n * with `CONFIG_INVALID` instead of misbehaving.\n */\nimport { ConfigError } from '../../core/errors/error';\nimport type { Capability } from '../../core/model/capability';\nimport type { ChainInfo, NetworkInfo } from '../../core/model/chain';\nimport { unknownName } from '../../core/util/names';\nimport { MAX_PRICE_VARIANT } from './fees';\nimport { decodeBase58 } from './keys';\n\n/** Every capability a Solana network has; a network may remove some. */\nexport const SOLANA_CAPABILITIES: readonly Capability[] = Object.freeze([\n  'tokens',\n  'memo',\n  'block-scan',\n  'address-history',\n  'expiry',\n]);\n\n/**\n * The highest compute-unit price a transfer signs unless the handle's `maxComputeUnitPrice`\n * option allows more: 10,000,000 micro-lamports per compute unit. A speed's\n * price comes from one endpoint's `getRecentPrioritizationFees` and its limit from one\n * endpoint's simulation (up to 1,400,000 units), so this operator bound is the only one no\n * node can raise. At the largest limit it caps a transfer's priority fee at 14,000,000\n * lamports (0.014 SOL).\n */\nexport const DEFAULT_MAX_COMPUTE_UNIT_PRICE = 10_000_000n;\nconst U64_MAX = 2n ** 64n - 1n;\n\nexport interface SolanaNetworkConfig {\n  /** The genesis hash every endpoint must report (`getGenesisHash`). */\n  readonly genesisHash: string;\n  readonly capabilities: ReadonlySet<Capability>;\n  /**\n   * The largest compute-unit price a transfer signs, in micro-lamports per compute unit:\n   * from 999 (the largest build variant, which a speed keeps at the bound) to 2^64 − 1.\n   */\n  readonly maxComputeUnitPrice: bigint;\n}\n\n/**\n * The only driver option (`HandleOptions.options`) the Solana driver reads. Any other key is\n * refused, so a typo, or another family's option such as Tron's `maxFeeLimit`, fails loudly\n * instead of leaving the default in place.\n */\nconst OPTION_KEYS: readonly string[] = Object.freeze(['maxComputeUnitPrice']);\n\n/** A price bound: a bigint of micro-lamports per compute unit that leaves room for a variant. */\nfunction priceBound(\n  value: unknown,\n  name: string,\n  fail: (reason: string) => never,\n): bigint {\n  if (typeof value !== 'bigint' || value < MAX_PRICE_VARIANT || value > U64_MAX) {\n    fail(\n      `${name} must be a bigint of micro-lamports per compute unit from 999 to 2^64 − 1`,\n    );\n  }\n  return value as bigint;\n}\n\nexport function solanaNetworkConfig(\n  chain: ChainInfo,\n  network: NetworkInfo,\n  options: Readonly<Record<string, unknown>> = {},\n): SolanaNetworkConfig {\n  const fail = (reason: string): never => {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `Solana network ${chain.id}:${network.id}: ${reason}`,\n    );\n  };\n  if (chain.model !== 'account' || chain.ordering !== 'expiry') {\n    fail('the chain must use the account model and expiry ordering');\n  }\n  if (chain.schemes.length !== 1 || chain.schemes[0] !== 'ed25519') {\n    fail(`its only scheme must be 'ed25519'`);\n  }\n  if (chain.nativeAsset.decimals !== 9)\n    fail('the native asset has 9 decimals (lamports)');\n  if (decodeBase58(network.identity, 32) === null) {\n    fail('its identity must be the base58 genesis hash');\n  }\n  if (network.feeModel !== 'solana') fail(`its fee model must be 'solana'`);\n  const { finality } = network;\n  if (finality.kind !== 'commitment' || finality.level !== 'finalized') {\n    fail(`its finality must be the 'finalized' commitment`);\n  }\n  if (network.replacement !== undefined) fail('Solana has no replace or cancel');\n  const capabilities = new Set<Capability>(SOLANA_CAPABILITIES);\n  for (const c of network.capabilities?.add ?? []) capabilities.add(c);\n  for (const c of network.capabilities?.remove ?? []) capabilities.delete(c);\n  for (const c of ['replace-fee', 'cancel', 'batch-transfer'] as const) {\n    if (capabilities.has(c)) fail(`the Solana driver cannot offer '${c}'`);\n  }\n  if (!capabilities.has('expiry')) fail(`'expiry' is how Solana orders transactions`);\n  // The refusal lists the accepted name and shows neither the caller's key, which\n  // may be a pasted secret, nor its value.\n  for (const key of Object.keys(options)) {\n    if (!OPTION_KEYS.includes(key)) {\n      fail(unknownName('option', OPTION_KEYS));\n    }\n  }\n  // The handle's option, else the network entry's own, else the default. A network value\n  // is checked even where an option overrides it.\n  const own = network.params?.maxComputeUnitPrice;\n  const networkBound =\n    own === undefined ? undefined : priceBound(own, 'params.maxComputeUnitPrice', fail);\n  const maxComputeUnitPrice =\n    options.maxComputeUnitPrice !== undefined\n      ? priceBound(options.maxComputeUnitPrice, 'maxComputeUnitPrice', fail)\n      : (networkBound ?? DEFAULT_MAX_COMPUTE_UNIT_PRICE);\n  return { genesisHash: network.identity as string, capabilities, maxComputeUnitPrice };\n}\n"]}

package/dist/adapters/solana/plugin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The Solana family plugin: the chain, tokens and provider presets as data, plus
+ * one adapter manifest. SDK-free: only the manifest's `load()` requires the `@solana/web3.js`
+ * module, and with it the SDK.
+ */
+import type { AdapterManifest, PeerDependency } from '../../core/driver/types';
+import type { Plugin } from '../../core/registry/plugin';
+/** The SDK versions this adapter is validated against, keyed by library. */
+export declare const SOLANA_PEER_DEPENDENCIES: Readonly<Record<'@solana/web3.js', PeerDependency>>;
+/**
+ * The `@solana/web3.js` manifest, built once, at module level, like the presets. Plugins
+ * compare functions by identity, so every `solanaPlugin()` carries the same `load`
+ * function and registering it again is the same plugin, not a conflicting one
+ * (`CONFIG_INVALID`).
+ */
+export declare const solanaManifest: AdapterManifest;
+/** The built-in Solana family: mainnet, devnet and testnet. */
+export declare function solanaPlugin(): Plugin;

package/dist/adapters/solana/plugin.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.solanaManifest = exports.SOLANA_PEER_DEPENDENCIES = void 0;
+exports.solanaPlugin = solanaPlugin;
+const chains_1 = require("./chains");
+const network_1 = require("./network");
+const presets_1 = require("./presets");
+const tokens_1 = require("./tokens");
+/** The SDK versions this adapter is validated against, keyed by library. */
+exports.SOLANA_PEER_DEPENDENCIES = Object.freeze({
+    '@solana/web3.js': Object.freeze({ name: '@solana/web3.js', range: '^1.99.0' }),
+});
+/**
+ * The `@solana/web3.js` manifest, built once, at module level, like the presets. Plugins
+ * compare functions by identity, so every `solanaPlugin()` carries the same `load`
+ * function and registering it again is the same plugin, not a conflicting one
+ * (`CONFIG_INVALID`).
+ */
+exports.solanaManifest = Object.freeze({
+    family: 'solana',
+    library: '@solana/web3.js',
+    chains: Object.freeze(['solana']),
+    capabilities: network_1.SOLANA_CAPABILITIES,
+    peerDependencies: Object.freeze([exports.SOLANA_PEER_DEPENDENCIES['@solana/web3.js']]),
+    load: async () => {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const mod = require('./web3');
+        return mod.web3DriverFactory;
+    },
+});
+/** The built-in Solana family: mainnet, devnet and testnet. */
+function solanaPlugin() {
+    return {
+        name: 'solana',
+        chains: [chains_1.SOLANA_CHAIN],
+        adapters: [exports.solanaManifest],
+        presets: presets_1.SOLANA_PRESETS,
+        assets: tokens_1.SOLANA_TOKENS,
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/adapters/solana/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/adapters/solana/plugin.ts"],"names":[],"mappings":";;;AA2CA,oCAQC;AAxCD,qCAAwC;AACxC,uCAAgD;AAChD,uCAA2C;AAC3C,qCAAyC;AAEzC,4EAA4E;AAC/D,QAAA,wBAAwB,GAEjC,MAAM,CAAC,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;CAChF,CAAC,CAAC;AAEH;;;;;GAKG;AACU,QAAA,cAAc,GAAoB,MAAM,CAAC,MAAM,CAAC;IAC3D,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjC,YAAY,EAAE,6BAAmB;IACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,gCAAwB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9E,IAAI,EAAE,KAAK,IAA4B,EAAE;QACvC,iEAAiE;QACjE,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAA4B,CAAC;QACzD,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC/B,CAAC;CACF,CAAC,CAAC;AAEH,+DAA+D;AAC/D,SAAgB,YAAY;IAC1B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,CAAC,qBAAY,CAAC;QACtB,QAAQ,EAAE,CAAC,sBAAc,CAAC;QAC1B,OAAO,EAAE,wBAAc;QACvB,MAAM,EAAE,sBAAa;KACtB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The Solana family plugin: the chain, tokens and provider presets as data, plus\n * one adapter manifest. SDK-free: only the manifest's `load()` requires the `@solana/web3.js`\n * module, and with it the SDK.\n */\nimport type {\n  AdapterManifest,\n  DriverFactory,\n  PeerDependency,\n} from '../../core/driver/types';\nimport type { Plugin } from '../../core/registry/plugin';\nimport { SOLANA_CHAIN } from './chains';\nimport { SOLANA_CAPABILITIES } from './network';\nimport { SOLANA_PRESETS } from './presets';\nimport { SOLANA_TOKENS } from './tokens';\n\n/** The SDK versions this adapter is validated against, keyed by library. */\nexport const SOLANA_PEER_DEPENDENCIES: Readonly<\n  Record<'@solana/web3.js', PeerDependency>\n> = Object.freeze({\n  '@solana/web3.js': Object.freeze({ name: '@solana/web3.js', range: '^1.99.0' }),\n});\n\n/**\n * The `@solana/web3.js` manifest, built once, at module level, like the presets. Plugins\n * compare functions by identity, so every `solanaPlugin()` carries the same `load`\n * function and registering it again is the same plugin, not a conflicting one\n * (`CONFIG_INVALID`).\n */\nexport const solanaManifest: AdapterManifest = Object.freeze({\n  family: 'solana',\n  library: '@solana/web3.js',\n  chains: Object.freeze(['solana']),\n  capabilities: SOLANA_CAPABILITIES,\n  peerDependencies: Object.freeze([SOLANA_PEER_DEPENDENCIES['@solana/web3.js']]),\n  load: async (): Promise<DriverFactory> => {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const mod = require('./web3') as typeof import('./web3');\n    return mod.web3DriverFactory;\n  },\n});\n\n/** The built-in Solana family: mainnet, devnet and testnet. */\nexport function solanaPlugin(): Plugin {\n  return {\n    name: 'solana',\n    chains: [SOLANA_CHAIN],\n    adapters: [solanaManifest],\n    presets: SOLANA_PRESETS,\n    assets: SOLANA_TOKENS,\n  };\n}\n"]}

package/dist/adapters/solana/presets.d.ts

@@ -0,0 +1,2 @@
+import type { ProviderPreset } from '../../core/registry/providers';
+export declare const SOLANA_PRESETS: readonly ProviderPreset[];

package/dist/adapters/solana/presets.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOLANA_PRESETS = void 0;
+/**
+ * Solana provider presets. Only URL templates verified against the provider's own
+ * documentation are listed; a preset refuses every other cluster with `CONFIG_INVALID`.
+ * Keyed URLs are `Secret`s, so the key never reaches logs or errors.
+ */
+const error_1 = require("../../core/errors/error");
+const secret_1 = require("../../core/secret/secret");
+const freeze_1 = require("../../core/util/freeze");
+/** The rate-limited public endpoints the Solana documentation lists (not for production). */
+const PUBLIC = {
+    mainnet: 'https://api.mainnet.solana.com',
+    devnet: 'https://api.devnet.solana.com',
+    testnet: 'https://api.testnet.solana.com',
+};
+/**
+ * The public RPC's published per-IP limits: 100 requests per 10 s, 40 per 10 s for a
+ * single method, 40 concurrent connections, so 4 rps. The transport's bucket is per
+ * endpoint, not per method, and the published per-method figure does not hold for
+ * `getBlock`: devnet and testnet answered HTTP 429 (`Retry-After: 10`) after about 6
+ * `getBlock` calls per 10 s in September 2026. This rate does not keep a block scan or a
+ * window proof under that; a scan waits out each 429 and falls behind, and a window proof
+ * completes over many passes. The preset still keeps the published rate: a keyless preset
+ * sets only a rate its operator publishes, since a guessed one throttles for nothing or
+ * protects nothing.
+ */
+const PUBLIC_RPS = 4;
+/** `https://<host>.g.alchemy.com/v2/<key>`. */
+const ALCHEMY = { mainnet: 'solana-mainnet', devnet: 'solana-devnet' };
+/** `https://<host>.infura.io/v3/<key>`. */
+const INFURA = { mainnet: 'solana-mainnet', devnet: 'solana-devnet' };
+/** `https://rpc.ankr.com/<path>/<key>`. */
+const ANKR = { mainnet: 'solana', devnet: 'solana_devnet' };
+const supports = (table) => (chain, network) => chain === 'solana' && Object.hasOwn(table, network);
+function entry(table, input) {
+    const value = Object.hasOwn(table, input.network) ? table[input.network] : undefined;
+    // Unreachable through the catalog, which asks `supports` first.
+    if (value === undefined)
+        throw new Error(`no entry for ${input.chain}:${input.network}`);
+    return value;
+}
+/** The revealed key; the error names the preset and network, never the key. */
+function apiKeyOf(name, input) {
+    const key = input.apiKey === undefined ? undefined : (0, secret_1.reveal)(input.apiKey);
+    if (typeof key !== 'string' || key.trim() === '') {
+        throw new error_1.ConfigError('CONFIG_INVALID', `provider preset '${name}' requires a non-empty apiKey for ${input.chain}:${input.network}`);
+    }
+    return key;
+}
+function keyed(name, table, url) {
+    return {
+        name,
+        kind: 'rpc',
+        requiresApiKey: true,
+        supports: supports(table),
+        endpoints: (input) => [
+            { name, url: (0, secret_1.secret)(url(entry(table, input), apiKeyOf(name, input))) },
+        ],
+    };
+}
+exports.SOLANA_PRESETS = (0, freeze_1.deepFreeze)([
+    {
+        name: 'public',
+        kind: 'rpc',
+        production: false,
+        supports: supports(PUBLIC),
+        endpoints: (input) => [
+            { name: 'public', url: entry(PUBLIC, input), rateLimit: { rps: PUBLIC_RPS } },
+        ],
+    },
+    keyed('alchemy', ALCHEMY, (host, key) => `https://${host}.g.alchemy.com/v2/${key}`),
+    keyed('infura', INFURA, (host, key) => `https://${host}.infura.io/v3/${key}`),
+    keyed('ankr', ANKR, (path, key) => `https://rpc.ankr.com/${path}/${key}`),
+]);
+//# sourceMappingURL=presets.js.map

package/dist/adapters/solana/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/adapters/solana/presets.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,mDAAsD;AAEtD,qDAA0D;AAE1D,mDAAoD;AAIpD,6FAA6F;AAC7F,MAAM,MAAM,GAAU;IACpB,OAAO,EAAE,gCAAgC;IACzC,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,gCAAgC;CAC1C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB,+CAA+C;AAC/C,MAAM,OAAO,GAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AAE9E,2CAA2C;AAC3C,MAAM,MAAM,GAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AAE7E,2CAA2C;AAC3C,MAAM,IAAI,GAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AAEnE,MAAM,QAAQ,GACZ,CAAC,KAAY,EAAE,EAAE,CACjB,CAAC,KAAa,EAAE,OAAe,EAAW,EAAE,CAC1C,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAExD,SAAS,KAAK,CAAC,KAAY,EAAE,KAAkB;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,gEAAgE;IAChE,IAAI,KAAK,KAAK,SAAS;QACrB,MAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAkB;IAChD,MAAM,GAAG,GAAY,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,eAAM,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnF,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,mBAAW,CACnB,gBAAgB,EAChB,oBAAoB,IAAI,qCAAqC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,KAAK,CACZ,IAAY,EACZ,KAAY,EACZ,GAA2C;IAE3C,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,KAAK;QACX,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;QACzB,SAAS,EAAE,CAAC,KAAK,EAA6B,EAAE,CAAC;YAC/C,EAAE,IAAI,EAAE,GAAG,EAAE,IAAA,eAAM,EAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE;SACvE;KACF,CAAC;AACJ,CAAC;AAEY,QAAA,cAAc,GAA8B,IAAA,mBAAU,EAAC;IAClE;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC;QAC1B,SAAS,EAAE,CAAC,KAAkB,EAAE,EAAE,CAAC;YACjC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE;SAC9E;KACF;IACD,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,WAAW,IAAI,qBAAqB,GAAG,EAAE,CAAC;IACnF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,WAAW,IAAI,iBAAiB,GAAG,EAAE,CAAC;IAC7E,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,wBAAwB,IAAI,IAAI,GAAG,EAAE,CAAC;CAC1E,CAAC,CAAC","sourcesContent":["/**\n * Solana provider presets. Only URL templates verified against the provider's own\n * documentation are listed; a preset refuses every other cluster with `CONFIG_INVALID`.\n * Keyed URLs are `Secret`s, so the key never reaches logs or errors.\n */\nimport { ConfigError } from '../../core/errors/error';\nimport type { PresetInput, ProviderPreset } from '../../core/registry/providers';\nimport { reveal, secret } from '../../core/secret/secret';\nimport type { EndpointConfig } from '../../core/transport/types';\nimport { deepFreeze } from '../../core/util/freeze';\n\ntype Table = Readonly<Record<string, string>>;\n\n/** The rate-limited public endpoints the Solana documentation lists (not for production). */\nconst PUBLIC: Table = {\n  mainnet: 'https://api.mainnet.solana.com',\n  devnet: 'https://api.devnet.solana.com',\n  testnet: 'https://api.testnet.solana.com',\n};\n\n/**\n * The public RPC's published per-IP limits: 100 requests per 10 s, 40 per 10 s for a\n * single method, 40 concurrent connections, so 4 rps. The transport's bucket is per\n * endpoint, not per method, and the published per-method figure does not hold for\n * `getBlock`: devnet and testnet answered HTTP 429 (`Retry-After: 10`) after about 6\n * `getBlock` calls per 10 s in September 2026. This rate does not keep a block scan or a\n * window proof under that; a scan waits out each 429 and falls behind, and a window proof\n * completes over many passes. The preset still keeps the published rate: a keyless preset\n * sets only a rate its operator publishes, since a guessed one throttles for nothing or\n * protects nothing.\n */\nconst PUBLIC_RPS = 4;\n\n/** `https://<host>.g.alchemy.com/v2/<key>`. */\nconst ALCHEMY: Table = { mainnet: 'solana-mainnet', devnet: 'solana-devnet' };\n\n/** `https://<host>.infura.io/v3/<key>`. */\nconst INFURA: Table = { mainnet: 'solana-mainnet', devnet: 'solana-devnet' };\n\n/** `https://rpc.ankr.com/<path>/<key>`. */\nconst ANKR: Table = { mainnet: 'solana', devnet: 'solana_devnet' };\n\nconst supports =\n  (table: Table) =>\n  (chain: string, network: string): boolean =>\n    chain === 'solana' && Object.hasOwn(table, network);\n\nfunction entry(table: Table, input: PresetInput): string {\n  const value = Object.hasOwn(table, input.network) ? table[input.network] : undefined;\n  // Unreachable through the catalog, which asks `supports` first.\n  if (value === undefined)\n    throw new Error(`no entry for ${input.chain}:${input.network}`);\n  return value;\n}\n\n/** The revealed key; the error names the preset and network, never the key. */\nfunction apiKeyOf(name: string, input: PresetInput): string {\n  const key: unknown = input.apiKey === undefined ? undefined : reveal(input.apiKey);\n  if (typeof key !== 'string' || key.trim() === '') {\n    throw new ConfigError(\n      'CONFIG_INVALID',\n      `provider preset '${name}' requires a non-empty apiKey for ${input.chain}:${input.network}`,\n    );\n  }\n  return key;\n}\n\nfunction keyed(\n  name: string,\n  table: Table,\n  url: (value: string, key: string) => string,\n): ProviderPreset {\n  return {\n    name,\n    kind: 'rpc',\n    requiresApiKey: true,\n    supports: supports(table),\n    endpoints: (input): readonly EndpointConfig[] => [\n      { name, url: secret(url(entry(table, input), apiKeyOf(name, input))) },\n    ],\n  };\n}\n\nexport const SOLANA_PRESETS: readonly ProviderPreset[] = deepFreeze([\n  {\n    name: 'public',\n    kind: 'rpc',\n    production: false,\n    supports: supports(PUBLIC),\n    endpoints: (input: PresetInput) => [\n      { name: 'public', url: entry(PUBLIC, input), rateLimit: { rps: PUBLIC_RPS } },\n    ],\n  },\n  keyed('alchemy', ALCHEMY, (host, key) => `https://${host}.g.alchemy.com/v2/${key}`),\n  keyed('infura', INFURA, (host, key) => `https://${host}.infura.io/v3/${key}`),\n  keyed('ankr', ANKR, (path, key) => `https://rpc.ankr.com/${path}/${key}`),\n]);\n"]}

package/dist/adapters/solana/programs.d.ts

@@ -0,0 +1,44 @@
+import type { SolanaInstruction } from './types';
+export declare const SYSTEM_PROGRAM = "11111111111111111111111111111111";
+export declare const TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+export declare const TOKEN_2022_PROGRAM = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+export declare const ASSOCIATED_TOKEN_PROGRAM = "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+export declare const MEMO_PROGRAM = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
+/** The first Memo program; still parsed on received transactions. */
+export declare const MEMO_V1_PROGRAM = "Memo1UhkJRfHyvLMcVucJwxXeuD728EqVDDwQDxFMNo";
+export declare const COMPUTE_BUDGET_PROGRAM = "ComputeBudget111111111111111111111111111111";
+export declare const VOTE_PROGRAM = "Vote111111111111111111111111111111111111111";
+/** Classic Token program account sizes (bytes). */
+export declare const MINT_SIZE = 82;
+export declare const TOKEN_ACCOUNT_SIZE = 165;
+/** A transaction's maximum serialized size (the network packet limit). */
+export declare const MAX_TRANSACTION_SIZE = 1232;
+/** The compute-unit limit of one transaction, and the default per instruction. */
+export declare const MAX_COMPUTE_UNIT_LIMIT = 1400000n;
+export declare const DEFAULT_INSTRUCTION_COMPUTE_UNITS = 200000n;
+/** Memo text limit (UTF-8 bytes): a library policy that keeps every transfer well under
+ *  the packet limit. */
+export declare const MAX_MEMO_BYTES = 256;
+/** ComputeBudget `SetComputeUnitLimit` (2, u32). */
+export declare function setComputeUnitLimit(units: bigint): SolanaInstruction;
+/** ComputeBudget `SetComputeUnitPrice` (3, u64 micro-lamports). */
+export declare function setComputeUnitPrice(microLamports: bigint): SolanaInstruction;
+/** System `Transfer` (2, u64 lamports). */
+export declare function systemTransfer(from: string, to: string, lamports: bigint): SolanaInstruction;
+/** Associated Token Account `CreateIdempotent` (1). */
+export declare function createAssociatedTokenAccountIdempotent(payer: string, associated: string, owner: string, mint: string): SolanaInstruction;
+/** Token `TransferChecked` (12, u64 amount, u8 decimals). */
+export declare function transferChecked(source: string, mint: string, destination: string, authority: string, amount: bigint, decimals: number): SolanaInstruction;
+/** Memo v2: the UTF-8 text, no accounts. */
+export declare function memo(text: string): SolanaInstruction;
+/** A classic Token mint (82 bytes): its decimals, when initialized. */
+export declare function decodeMint(data: Uint8Array): {
+    readonly decimals: number;
+} | null;
+/** A classic Token account (165 bytes): mint, owner, amount and state. */
+export declare function decodeTokenAccount(data: Uint8Array): {
+    readonly mint: Uint8Array;
+    readonly owner: Uint8Array;
+    readonly amount: bigint;
+    readonly frozen: boolean;
+} | null;

package/dist/adapters/solana/programs.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_MEMO_BYTES = exports.DEFAULT_INSTRUCTION_COMPUTE_UNITS = exports.MAX_COMPUTE_UNIT_LIMIT = exports.MAX_TRANSACTION_SIZE = exports.TOKEN_ACCOUNT_SIZE = exports.MINT_SIZE = exports.VOTE_PROGRAM = exports.COMPUTE_BUDGET_PROGRAM = exports.MEMO_V1_PROGRAM = exports.MEMO_PROGRAM = exports.ASSOCIATED_TOKEN_PROGRAM = exports.TOKEN_2022_PROGRAM = exports.TOKEN_PROGRAM = exports.SYSTEM_PROGRAM = void 0;
+exports.setComputeUnitLimit = setComputeUnitLimit;
+exports.setComputeUnitPrice = setComputeUnitPrice;
+exports.systemTransfer = systemTransfer;
+exports.createAssociatedTokenAccountIdempotent = createAssociatedTokenAccountIdempotent;
+exports.transferChecked = transferChecked;
+exports.memo = memo;
+exports.decodeMint = decodeMint;
+exports.decodeTokenAccount = decodeTokenAccount;
+/**
+ * Solana program ids, account layouts and the instructions the driver builds, SDK-free
+ * (built without `@solana/spl-token`). Every encoding is checked against a real devnet
+ * transaction and `@solana/web3.js`'s own builders (`codec.test.ts`).
+ */
+const error_1 = require("../../core/errors/error");
+exports.SYSTEM_PROGRAM = '11111111111111111111111111111111';
+exports.TOKEN_PROGRAM = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+exports.TOKEN_2022_PROGRAM = 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb';
+exports.ASSOCIATED_TOKEN_PROGRAM = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';
+exports.MEMO_PROGRAM = 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr';
+/** The first Memo program; still parsed on received transactions. */
+exports.MEMO_V1_PROGRAM = 'Memo1UhkJRfHyvLMcVucJwxXeuD728EqVDDwQDxFMNo';
+exports.COMPUTE_BUDGET_PROGRAM = 'ComputeBudget111111111111111111111111111111';
+exports.VOTE_PROGRAM = 'Vote111111111111111111111111111111111111111';
+/** Classic Token program account sizes (bytes). */
+exports.MINT_SIZE = 82;
+exports.TOKEN_ACCOUNT_SIZE = 165;
+/** A transaction's maximum serialized size (the network packet limit). */
+exports.MAX_TRANSACTION_SIZE = 1232;
+/** The compute-unit limit of one transaction, and the default per instruction. */
+exports.MAX_COMPUTE_UNIT_LIMIT = 1400000n;
+exports.DEFAULT_INSTRUCTION_COMPUTE_UNITS = 200000n;
+/** Memo text limit (UTF-8 bytes): a library policy that keeps every transfer well under
+ *  the packet limit. */
+exports.MAX_MEMO_BYTES = 256;
+/**
+ * DataView and `Uint8Array.of` silently wrap a value that does not fit (2^64 + 5 lamports
+ * would encode as 5); we refuse it with a fixed text: `INVALID_AMOUNT` for a u64
+ * (lamports, token amounts and micro-lamports), `INVALID_INTENT` for a u8 (decimals) or a
+ * u32 (compute units).
+ */
+const outOfRange = (bits) => new error_1.ValidationError(bits === 64 ? 'INVALID_AMOUNT' : 'INVALID_INTENT', `a value does not fit in its u${bits} field`);
+function u8(value) {
+    if (!Number.isInteger(value) || value < 0 || value > 0xff)
+        throw outOfRange(8);
+    return Uint8Array.of(value);
+}
+function u32(value) {
+    if (value < 0n || value > 0xffffffffn)
+        throw outOfRange(32);
+    const out = new Uint8Array(4);
+    new DataView(out.buffer).setUint32(0, Number(value), true);
+    return out;
+}
+function u64(value) {
+    if (value < 0n || value >= 2n ** 64n)
+        throw outOfRange(64);
+    const out = new Uint8Array(8);
+    new DataView(out.buffer).setBigUint64(0, value, true);
+    return out;
+}
+const bytes = (...parts) => {
+    const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return out;
+};
+const signer = (address, writable) => ({
+    address,
+    signer: true,
+    writable,
+});
+const account = (address, writable) => ({
+    address,
+    signer: false,
+    writable,
+});
+/** ComputeBudget `SetComputeUnitLimit` (2, u32). */
+function setComputeUnitLimit(units) {
+    return {
+        programId: exports.COMPUTE_BUDGET_PROGRAM,
+        accounts: [],
+        data: bytes(Uint8Array.of(2), u32(units)),
+    };
+}
+/** ComputeBudget `SetComputeUnitPrice` (3, u64 micro-lamports). */
+function setComputeUnitPrice(microLamports) {
+    return {
+        programId: exports.COMPUTE_BUDGET_PROGRAM,
+        accounts: [],
+        data: bytes(Uint8Array.of(3), u64(microLamports)),
+    };
+}
+/** System `Transfer` (2, u64 lamports). */
+function systemTransfer(from, to, lamports) {
+    return {
+        programId: exports.SYSTEM_PROGRAM,
+        accounts: [signer(from, true), account(to, true)],
+        data: bytes(u32(2n), u64(lamports)),
+    };
+}
+/** Associated Token Account `CreateIdempotent` (1). */
+function createAssociatedTokenAccountIdempotent(payer, associated, owner, mint) {
+    return {
+        programId: exports.ASSOCIATED_TOKEN_PROGRAM,
+        accounts: [
+            signer(payer, true),
+            account(associated, true),
+            account(owner, false),
+            account(mint, false),
+            account(exports.SYSTEM_PROGRAM, false),
+            account(exports.TOKEN_PROGRAM, false),
+        ],
+        data: Uint8Array.of(1),
+    };
+}
+/** Token `TransferChecked` (12, u64 amount, u8 decimals). */
+function transferChecked(source, mint, destination, authority, amount, decimals) {
+    return {
+        programId: exports.TOKEN_PROGRAM,
+        accounts: [
+            account(source, true),
+            account(mint, false),
+            account(destination, true),
+            signer(authority, false),
+        ],
+        data: bytes(Uint8Array.of(12), u64(amount), u8(decimals)),
+    };
+}
+/** Memo v2: the UTF-8 text, no accounts. */
+function memo(text) {
+    return { programId: exports.MEMO_PROGRAM, accounts: [], data: new TextEncoder().encode(text) };
+}
+/** A classic Token mint (82 bytes): its decimals, when initialized. */
+function decodeMint(data) {
+    if (data.length !== exports.MINT_SIZE || data[45] !== 1)
+        return null;
+    return { decimals: data[44] };
+}
+/** A classic Token account (165 bytes): mint, owner, amount and state. */
+function decodeTokenAccount(data) {
+    if (data.length !== exports.TOKEN_ACCOUNT_SIZE)
+        return null;
+    const state = data[108];
+    if (state !== 1 && state !== 2)
+        return null;
+    return {
+        mint: data.slice(0, 32),
+        owner: data.slice(32, 64),
+        amount: new DataView(data.buffer, data.byteOffset + 64, 8).getBigUint64(0, true),
+        frozen: state === 2,
+    };
+}
+//# sourceMappingURL=programs.js.map

package/dist/adapters/solana/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../../src/adapters/solana/programs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Solana program ids, account layouts and the instructions the driver builds, SDK-free\n * (built without `@solana/spl-token`). Every encoding is checked against a real devnet\n * transaction and `@solana/web3.js`'s own builders (`codec.test.ts`).\n */\nimport { ValidationError } from '../../core/errors/error';\nimport type { SolanaInstruction } from './types';\n\nexport const SYSTEM_PROGRAM = '11111111111111111111111111111111';\nexport const TOKEN_PROGRAM = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';\nexport const TOKEN_2022_PROGRAM = 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb';\nexport const ASSOCIATED_TOKEN_PROGRAM = 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL';\nexport const MEMO_PROGRAM = 'MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr';\n/** The first Memo program; still parsed on received transactions. */\nexport const MEMO_V1_PROGRAM = 'Memo1UhkJRfHyvLMcVucJwxXeuD728EqVDDwQDxFMNo';\nexport const COMPUTE_BUDGET_PROGRAM = 'ComputeBudget111111111111111111111111111111';\nexport const VOTE_PROGRAM = 'Vote111111111111111111111111111111111111111';\n\n/** Classic Token program account sizes (bytes). */\nexport const MINT_SIZE = 82;\nexport const TOKEN_ACCOUNT_SIZE = 165;\n/** A transaction's maximum serialized size (the network packet limit). */\nexport const MAX_TRANSACTION_SIZE = 1232;\n/** The compute-unit limit of one transaction, and the default per instruction. */\nexport const MAX_COMPUTE_UNIT_LIMIT = 1_400_000n;\nexport const DEFAULT_INSTRUCTION_COMPUTE_UNITS = 200_000n;\n/** Memo text limit (UTF-8 bytes): a library policy that keeps every transfer well under\n *  the packet limit. */\nexport const MAX_MEMO_BYTES = 256;\n\n/**\n * DataView and `Uint8Array.of` silently wrap a value that does not fit (2^64 + 5 lamports\n * would encode as 5); we refuse it with a fixed text: `INVALID_AMOUNT` for a u64\n * (lamports, token amounts and micro-lamports), `INVALID_INTENT` for a u8 (decimals) or a\n * u32 (compute units).\n */\nconst outOfRange = (bits: 8 | 32 | 64) =>\n  new ValidationError(\n    bits === 64 ? 'INVALID_AMOUNT' : 'INVALID_INTENT',\n    `a value does not fit in its u${bits} field`,\n  );\n\nfunction u8(value: number): Uint8Array {\n  if (!Number.isInteger(value) || value < 0 || value > 0xff) throw outOfRange(8);\n  return Uint8Array.of(value);\n}\n\nfunction u32(value: bigint): Uint8Array {\n  if (value < 0n || value > 0xffff_ffffn) throw outOfRange(32);\n  const out = new Uint8Array(4);\n  new DataView(out.buffer).setUint32(0, Number(value), true);\n  return out;\n}\n\nfunction u64(value: bigint): Uint8Array {\n  if (value < 0n || value >= 2n ** 64n) throw outOfRange(64);\n  const out = new Uint8Array(8);\n  new DataView(out.buffer).setBigUint64(0, value, true);\n  return out;\n}\n\nconst bytes = (...parts: Uint8Array[]): Uint8Array => {\n  const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));\n  let offset = 0;\n  for (const part of parts) {\n    out.set(part, offset);\n    offset += part.length;\n  }\n  return out;\n};\n\nconst signer = (address: string, writable: boolean) => ({\n  address,\n  signer: true,\n  writable,\n});\nconst account = (address: string, writable: boolean) => ({\n  address,\n  signer: false,\n  writable,\n});\n\n/** ComputeBudget `SetComputeUnitLimit` (2, u32). */\nexport function setComputeUnitLimit(units: bigint): SolanaInstruction {\n  return {\n    programId: COMPUTE_BUDGET_PROGRAM,\n    accounts: [],\n    data: bytes(Uint8Array.of(2), u32(units)),\n  };\n}\n\n/** ComputeBudget `SetComputeUnitPrice` (3, u64 micro-lamports). */\nexport function setComputeUnitPrice(microLamports: bigint): SolanaInstruction {\n  return {\n    programId: COMPUTE_BUDGET_PROGRAM,\n    accounts: [],\n    data: bytes(Uint8Array.of(3), u64(microLamports)),\n  };\n}\n\n/** System `Transfer` (2, u64 lamports). */\nexport function systemTransfer(\n  from: string,\n  to: string,\n  lamports: bigint,\n): SolanaInstruction {\n  return {\n    programId: SYSTEM_PROGRAM,\n    accounts: [signer(from, true), account(to, true)],\n    data: bytes(u32(2n), u64(lamports)),\n  };\n}\n\n/** Associated Token Account `CreateIdempotent` (1). */\nexport function createAssociatedTokenAccountIdempotent(\n  payer: string,\n  associated: string,\n  owner: string,\n  mint: string,\n): SolanaInstruction {\n  return {\n    programId: ASSOCIATED_TOKEN_PROGRAM,\n    accounts: [\n      signer(payer, true),\n      account(associated, true),\n      account(owner, false),\n      account(mint, false),\n      account(SYSTEM_PROGRAM, false),\n      account(TOKEN_PROGRAM, false),\n    ],\n    data: Uint8Array.of(1),\n  };\n}\n\n/** Token `TransferChecked` (12, u64 amount, u8 decimals). */\nexport function transferChecked(\n  source: string,\n  mint: string,\n  destination: string,\n  authority: string,\n  amount: bigint,\n  decimals: number,\n): SolanaInstruction {\n  return {\n    programId: TOKEN_PROGRAM,\n    accounts: [\n      account(source, true),\n      account(mint, false),\n      account(destination, true),\n      signer(authority, false),\n    ],\n    data: bytes(Uint8Array.of(12), u64(amount), u8(decimals)),\n  };\n}\n\n/** Memo v2: the UTF-8 text, no accounts. */\nexport function memo(text: string): SolanaInstruction {\n  return { programId: MEMO_PROGRAM, accounts: [], data: new TextEncoder().encode(text) };\n}\n\n/** A classic Token mint (82 bytes): its decimals, when initialized. */\nexport function decodeMint(data: Uint8Array): { readonly decimals: number } | null {\n  if (data.length !== MINT_SIZE || data[45] !== 1) return null;\n  return { decimals: data[44] as number };\n}\n\n/** A classic Token account (165 bytes): mint, owner, amount and state. */\nexport function decodeTokenAccount(data: Uint8Array): {\n  readonly mint: Uint8Array;\n  readonly owner: Uint8Array;\n  readonly amount: bigint;\n  readonly frozen: boolean;\n} | null {\n  if (data.length !== TOKEN_ACCOUNT_SIZE) return null;\n  const state = data[108];\n  if (state !== 1 && state !== 2) return null;\n  return {\n    mint: data.slice(0, 32),\n    owner: data.slice(32, 64),\n    amount: new DataView(data.buffer, data.byteOffset + 64, 8).getBigUint64(0, true),\n    frozen: state === 2,\n  };\n}\n"]}