crypto-aio 0.0.3 → 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/solana/index.ts"],"names":[],"mappings":";;;AAiBA,mCAAoD;AAA3C,kHAAA,wBAAwB,OAAA;AACjC,qCAAgF;AAAvE,yHAAA,8BAA8B,OAAA;AAAE,8GAAA,mBAAmB,OAAA","sourcesContent":["/**\n * `crypto-aio/solana`: the SDK-free Solana types, and the `crypto-aio/native` client type:\n * importing this entry types `native(bc, '@solana/web3.js')` as a `Connection` wired to the\n * handle's transport (HTTP JSON-RPC only; subscriptions have no transport bridge).\n *\n * @module crypto-aio/solana\n */\nimport type { Connection } from '@solana/web3.js';\n\n// Augments the package entry's map. SDK types appear only here, so the main entry's\n// typings name no SDK.\ndeclare module '../../index' {\n  interface NativeClientMap {\n    '@solana/web3.js': Connection;\n  }\n}\n\nexport { SOLANA_PEER_DEPENDENCIES } from './plugin';\nexport { DEFAULT_MAX_COMPUTE_UNIT_PRICE, SOLANA_CAPABILITIES } from './network';\nexport type {\n  SolanaExpiryOrdering,\n  SolanaExt,\n  SolanaFeeDetails,\n  SolanaFeeOverride,\n  SolanaTokenAccount,\n} from './types';\n"]}

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/message.d.ts

@@ -0,0 +1,15 @@
+import type { SolanaInstruction } from './types';
+/**
+ * `findProgramAddressSync`: the first bump from 255 down whose address is off the curve,
+ * so no private key can sign for it. A seed is at most 32 bytes, as the runtime requires.
+ */
+export declare function programAddress(seeds: readonly Uint8Array[], programId: string): string;
+/** The associated token account of `owner` for `mint` (classic Token program). */
+export declare function associatedTokenAddress(owner: string, mint: string): string;
+/**
+ * A legacy message by the Solana message rules, as `@solana/web3.js` compiles it: the
+ * payer first, then the signers (writable, then read-only) and the non-signers (writable,
+ * then read-only), each group in order of first appearance, an instruction's program id
+ * before its accounts; an account is a signer or writable when any use makes it one.
+ */
+export declare function compileLegacyMessage(payer: string, recentBlockhash: string, instructions: readonly SolanaInstruction[]): Uint8Array;

package/dist/adapters/solana/message.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.programAddress = programAddress;
+exports.associatedTokenAddress = associatedTokenAddress;
+exports.compileLegacyMessage = compileLegacyMessage;
+/**
+ * The two pieces of Solana's wire format the driver builds itself, SDK-free: a legacy
+ * message and a program-derived address. Both used to come from `@solana/web3.js`, whose
+ * 3.x line dropped the synchronous derivation and rebuilt its classes on Kit; owning them
+ * keeps every signed byte independent of the SDK version a user installs. `codec.test.ts`
+ * checks both against `@solana/web3.js` 1.99 and frozen vectors.
+ */
+const ed25519_1 = require("@noble/curves/ed25519");
+const sha256_1 = require("@noble/hashes/sha256");
+const base_1 = require("@scure/base");
+const error_1 = require("../../core/errors/error");
+const programs_1 = require("./programs");
+const wire_1 = require("./wire");
+const PDA_MARKER = new TextEncoder().encode('ProgramDerivedAddress');
+/** A 32-byte public key from its base58 text; the inputs are already validated. */
+function key(address) {
+    const bytes = base_1.base58.decode(address);
+    if (bytes.length !== 32) {
+        throw new error_1.ValidationError('INVALID_ADDRESS', 'a Solana key is 32 bytes');
+    }
+    return bytes;
+}
+/** Whether `bytes` is a point of the ed25519 curve, i.e. could have a private key. */
+function onCurve(bytes) {
+    try {
+        ed25519_1.ed25519.ExtendedPoint.fromHex(bytes);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * `findProgramAddressSync`: the first bump from 255 down whose address is off the curve,
+ * so no private key can sign for it. A seed is at most 32 bytes, as the runtime requires.
+ */
+function programAddress(seeds, programId) {
+    const program = key(programId);
+    for (let bump = 255; bump >= 0; bump--) {
+        const hash = sha256_1.sha256
+            .create()
+            .update(Uint8Array.from(seeds.flatMap((seed) => [...seed])))
+            .update(Uint8Array.of(bump))
+            .update(program)
+            .update(PDA_MARKER)
+            .digest();
+        if (!onCurve(hash))
+            return base_1.base58.encode(hash);
+    }
+    // Each bump has a one-in-two chance; all 256 failing does not happen.
+    throw new error_1.ValidationError('INVALID_ADDRESS', 'no program address for these seeds');
+}
+/** The associated token account of `owner` for `mint` (classic Token program). */
+function associatedTokenAddress(owner, mint) {
+    return programAddress([key(owner), key(programs_1.TOKEN_PROGRAM), key(mint)], programs_1.ASSOCIATED_TOKEN_PROGRAM);
+}
+/**
+ * A legacy message by the Solana message rules, as `@solana/web3.js` compiles it: the
+ * payer first, then the signers (writable, then read-only) and the non-signers (writable,
+ * then read-only), each group in order of first appearance, an instruction's program id
+ * before its accounts; an account is a signer or writable when any use makes it one.
+ */
+function compileLegacyMessage(payer, recentBlockhash, instructions) {
+    const meta = new Map();
+    const note = (address, signer, writable) => {
+        const seen = meta.get(address);
+        meta.set(address, {
+            signer: (seen?.signer ?? false) || signer,
+            writable: (seen?.writable ?? false) || writable,
+        });
+    };
+    note(payer, true, true);
+    for (const ix of instructions) {
+        note(ix.programId, false, false);
+        for (const account of ix.accounts)
+            note(account.address, account.signer, account.writable);
+    }
+    const entries = [...meta.entries()];
+    const group = (signer, writable) => entries
+        .filter(([, m]) => m.signer === signer && m.writable === writable)
+        .map(([address]) => address);
+    const writableSigners = group(true, true);
+    const readonlySigners = group(true, false);
+    const writableOthers = group(false, true);
+    const readonlyOthers = group(false, false);
+    const keys = [
+        ...writableSigners,
+        ...readonlySigners,
+        ...writableOthers,
+        ...readonlyOthers,
+    ];
+    // Indices are single bytes in a legacy message.
+    if (keys.length > 256) {
+        throw new error_1.ValidationError('INVALID_INTENT', 'too many accounts for one message');
+    }
+    const index = new Map(keys.map((address, i) => [address, i]));
+    const parts = [
+        Uint8Array.of(writableSigners.length + readonlySigners.length, readonlySigners.length, readonlyOthers.length),
+        (0, wire_1.encodeLength)(keys.length),
+        ...keys.map(key),
+        key(recentBlockhash),
+        (0, wire_1.encodeLength)(instructions.length),
+    ];
+    for (const ix of instructions) {
+        parts.push(Uint8Array.of(index.get(ix.programId)), (0, wire_1.encodeLength)(ix.accounts.length), Uint8Array.from(ix.accounts.map((a) => index.get(a.address))), (0, wire_1.encodeLength)(ix.data.length), ix.data);
+    }
+    const out = new Uint8Array(parts.reduce((n, part) => n + part.length, 0));
+    let offset = 0;
+    for (const part of parts) {
+        out.set(part, offset);
+        offset += part.length;
+    }
+    return out;
+}
+//# sourceMappingURL=message.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/adapters/solana/message.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The two pieces of Solana's wire format the driver builds itself, SDK-free: a legacy\n * message and a program-derived address. Both used to come from `@solana/web3.js`, whose\n * 3.x line dropped the synchronous derivation and rebuilt its classes on Kit; owning them\n * keeps every signed byte independent of the SDK version a user installs. `codec.test.ts`\n * checks both against `@solana/web3.js` 1.99 and frozen vectors.\n */\nimport { ed25519 } from '@noble/curves/ed25519';\nimport { sha256 } from '@noble/hashes/sha256';\nimport { base58 } from '@scure/base';\nimport { ValidationError } from '../../core/errors/error';\nimport { ASSOCIATED_TOKEN_PROGRAM, TOKEN_PROGRAM } from './programs';\nimport type { SolanaInstruction } from './types';\nimport { encodeLength } from './wire';\n\nconst PDA_MARKER = new TextEncoder().encode('ProgramDerivedAddress');\n\n/** A 32-byte public key from its base58 text; the inputs are already validated. */\nfunction key(address: string): Uint8Array {\n  const bytes = base58.decode(address);\n  if (bytes.length !== 32) {\n    throw new ValidationError('INVALID_ADDRESS', 'a Solana key is 32 bytes');\n  }\n  return bytes;\n}\n\n/** Whether `bytes` is a point of the ed25519 curve, i.e. could have a private key. */\nfunction onCurve(bytes: Uint8Array): boolean {\n  try {\n    ed25519.ExtendedPoint.fromHex(bytes);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * `findProgramAddressSync`: the first bump from 255 down whose address is off the curve,\n * so no private key can sign for it. A seed is at most 32 bytes, as the runtime requires.\n */\nexport function programAddress(seeds: readonly Uint8Array[], programId: string): string {\n  const program = key(programId);\n  for (let bump = 255; bump >= 0; bump--) {\n    const hash = sha256\n      .create()\n      .update(Uint8Array.from(seeds.flatMap((seed) => [...seed])))\n      .update(Uint8Array.of(bump))\n      .update(program)\n      .update(PDA_MARKER)\n      .digest();\n    if (!onCurve(hash)) return base58.encode(hash);\n  }\n  // Each bump has a one-in-two chance; all 256 failing does not happen.\n  throw new ValidationError('INVALID_ADDRESS', 'no program address for these seeds');\n}\n\n/** The associated token account of `owner` for `mint` (classic Token program). */\nexport function associatedTokenAddress(owner: string, mint: string): string {\n  return programAddress(\n    [key(owner), key(TOKEN_PROGRAM), key(mint)],\n    ASSOCIATED_TOKEN_PROGRAM,\n  );\n}\n\n/**\n * A legacy message by the Solana message rules, as `@solana/web3.js` compiles it: the\n * payer first, then the signers (writable, then read-only) and the non-signers (writable,\n * then read-only), each group in order of first appearance, an instruction's program id\n * before its accounts; an account is a signer or writable when any use makes it one.\n */\nexport function compileLegacyMessage(\n  payer: string,\n  recentBlockhash: string,\n  instructions: readonly SolanaInstruction[],\n): Uint8Array {\n  const meta = new Map<string, { signer: boolean; writable: boolean }>();\n  const note = (address: string, signer: boolean, writable: boolean) => {\n    const seen = meta.get(address);\n    meta.set(address, {\n      signer: (seen?.signer ?? false) || signer,\n      writable: (seen?.writable ?? false) || writable,\n    });\n  };\n  note(payer, true, true);\n  for (const ix of instructions) {\n    note(ix.programId, false, false);\n    for (const account of ix.accounts)\n      note(account.address, account.signer, account.writable);\n  }\n  const entries = [...meta.entries()];\n  const group = (signer: boolean, writable: boolean) =>\n    entries\n      .filter(([, m]) => m.signer === signer && m.writable === writable)\n      .map(([address]) => address);\n  const writableSigners = group(true, true);\n  const readonlySigners = group(true, false);\n  const writableOthers = group(false, true);\n  const readonlyOthers = group(false, false);\n  const keys = [\n    ...writableSigners,\n    ...readonlySigners,\n    ...writableOthers,\n    ...readonlyOthers,\n  ];\n  // Indices are single bytes in a legacy message.\n  if (keys.length > 256) {\n    throw new ValidationError('INVALID_INTENT', 'too many accounts for one message');\n  }\n  const index = new Map(keys.map((address, i) => [address, i]));\n  const parts: Uint8Array[] = [\n    Uint8Array.of(\n      writableSigners.length + readonlySigners.length,\n      readonlySigners.length,\n      readonlyOthers.length,\n    ),\n    encodeLength(keys.length),\n    ...keys.map(key),\n    key(recentBlockhash),\n    encodeLength(instructions.length),\n  ];\n  for (const ix of instructions) {\n    parts.push(\n      Uint8Array.of(index.get(ix.programId) as number),\n      encodeLength(ix.accounts.length),\n      Uint8Array.from(ix.accounts.map((a) => index.get(a.address) as number)),\n      encodeLength(ix.data.length),\n      ix.data,\n    );\n  }\n  const out = new Uint8Array(parts.reduce((n, part) => n + part.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"]}

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,44 @@
+"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 || ^3.0.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":";;;AA8CA,oCAQC;AA3CD,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;QAC/B,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,mBAAmB;KAC3B,CAAC;CACH,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({\n    name: '@solana/web3.js',\n    range: '^1.99.0 || ^3.0.0',\n  }),\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":"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","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;