@funkit/solana-web3 0.0.0-stage → 0.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { type CreateSolanaAdapterParams, type SolanaConnection, type SolanaSignAndSendTransaction, type SolanaSigner, type SolanaSignTransaction, createSolanaAdapter, } from './src/solanaAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,mBAAmB,GACpB,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,103 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  createSolanaAdapter: () => createSolanaAdapter
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/solanaAdapter.ts
+var import_fun_relay = require("@funkit/fun-relay");
+var import_relay_svm_wallet_adapter = require("@relayprotocol/relay-svm-wallet-adapter");
+var import_web3 = require("@solana/web3.js");
+var import_bs58 = __toESM(require("bs58"));
+var SIGNATURE_BYTE_LENGTH = 64;
+function resolveSubmit(signer, connection) {
+  const signTransaction = signer.signTransaction?.bind(signer);
+  const signAndSendTransaction = signer.signAndSendTransaction?.bind(signer);
+  if (signTransaction) {
+    return async (transaction, options) => {
+      const signed = await signTransaction(transaction);
+      try {
+        const signature = await connection.sendTransaction(signed, {
+          ...options,
+          maxRetries: 5
+        });
+        return { signature };
+      } catch (error) {
+        if (error instanceof import_web3.SendTransactionError) {
+          console.error(
+            "Failed transaction logs:",
+            error,
+            await error.getLogs(connection).catch(() => void 0)
+          );
+        }
+        throw error;
+      }
+    };
+  }
+  if (signAndSendTransaction) {
+    return async (transaction) => {
+      const signature = await signAndSendTransaction(transaction);
+      if (!(signature instanceof Uint8Array) || signature.length !== SIGNATURE_BYTE_LENGTH) {
+        throw new Error(
+          `signAndSendTransaction must resolve a ${SIGNATURE_BYTE_LENGTH}-byte signature. The transaction may already have been submitted.`
+        );
+      }
+      return { signature: import_bs58.default.encode(signature) };
+    };
+  }
+  throw new Error("Solana signer supplied no way to sign a transaction");
+}
+function resolveSigningMethod(params) {
+  if (params.signTransaction) {
+    return "signTransaction";
+  }
+  if (params.signAndSendTransaction) {
+    return "signAndSendTransaction";
+  }
+  return void 0;
+}
+function createSolanaAdapter(params) {
+  return {
+    engine: "web3",
+    address: params.address,
+    signingMethod: resolveSigningMethod(params),
+    createRelayWallet: () => (0, import_relay_svm_wallet_adapter.adaptSolanaWallet)(
+      params.address,
+      import_fun_relay.RELAY_SOLANA_CHAIN_ID_NUMBER,
+      params.connection,
+      resolveSubmit(params, params.connection),
+      params.payerKey
+    )
+  };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../index.ts", "../src/solanaAdapter.ts"],
+  "sourcesContent": ["// @funkit/solana-web3\n//\n// Builds the FunkitSolanaAdapter for hosts on @solana/web3.js, wrapping\n// Relay's SVM adapter. relay-sdk is a peer because the adapter reads its\n// module-level client: a second copy has no client and every transaction throws.\nexport {\n  type CreateSolanaAdapterParams,\n  type SolanaConnection,\n  type SolanaSignAndSendTransaction,\n  type SolanaSigner,\n  type SolanaSignTransaction,\n  createSolanaAdapter,\n} from './src/solanaAdapter'\n", "import {\n  type FunkitSolanaAdapter,\n  RELAY_SOLANA_CHAIN_ID_NUMBER,\n  type SolanaWallet,\n} from '@funkit/fun-relay'\nimport { adaptSolanaWallet } from '@relayprotocol/relay-svm-wallet-adapter'\nimport {\n  type Connection,\n  type SendOptions,\n  SendTransactionError,\n  type TransactionSignature,\n  type VersionedTransaction,\n} from '@solana/web3.js'\nimport bs58 from 'bs58'\n\n/** Ed25519, so the transaction id is always these many bytes. */\nconst SIGNATURE_BYTE_LENGTH = 64\n\n/** The host's web3.js connection, used for blockhashes and funkit's own submits. */\nexport type SolanaConnection = Connection\n\n/** Signs and hands the transaction back, for funkit to submit. */\nexport type SolanaSignTransaction = (\n  transaction: VersionedTransaction,\n) => Promise<VersionedTransaction>\n\n/** Signs and submits, resolving the transaction's 64-byte signature. */\nexport type SolanaSignAndSendTransaction = (\n  transaction: VersionedTransaction,\n) => Promise<Uint8Array>\n\n/**\n * At least one of the two. `signTransaction` wins when both are supplied, since\n * submitting through funkit is what applies the rebroadcast retries and logs.\n */\nexport type SolanaSigner =\n  | {\n      signTransaction: SolanaSignTransaction\n      signAndSendTransaction?: SolanaSignAndSendTransaction\n    }\n  | {\n      signTransaction?: SolanaSignTransaction\n      signAndSendTransaction: SolanaSignAndSendTransaction\n    }\n\nexport type CreateSolanaAdapterParams = {\n  /** Base58 address of the connected wallet. funkit validates it, not this factory. */\n  address: string\n  /** Use an endpoint you trust for write traffic; public RPCs rate-limit. */\n  connection: SolanaConnection\n  /** Base58 fee payer when it isn't `address`, e.g. a sponsor that co-signs. */\n  payerKey?: string\n} & SolanaSigner\n\n/** Relay's submission hook: sign (or sign-and-send) and return the signature. */\ntype RelaySubmit = (\n  transaction: VersionedTransaction,\n  options?: SendOptions,\n) => Promise<{ signature: TransactionSignature }>\n\nfunction resolveSubmit(\n  signer: SolanaSigner,\n  connection: Connection,\n): RelaySubmit {\n  // Bound to the host's object: a class-based signer loses `this` when its\n  // methods are pulled off or spread.\n  const signTransaction = signer.signTransaction?.bind(signer)\n  const signAndSendTransaction = signer.signAndSendTransaction?.bind(signer)\n\n  // Submitting here is what applies the rebroadcast retries and failure logs.\n  if (signTransaction) {\n    return async (transaction, options) => {\n      const signed = await signTransaction(transaction)\n      try {\n        const signature = await connection.sendTransaction(signed, {\n          ...options,\n          maxRetries: 5,\n        })\n\n        return { signature }\n      } catch (error) {\n        if (error instanceof SendTransactionError) {\n          console.error(\n            'Failed transaction logs:',\n            error,\n            await error.getLogs(connection).catch(() => undefined),\n          )\n        }\n\n        throw error\n      }\n    }\n  }\n\n  if (signAndSendTransaction) {\n    return async (transaction) => {\n      const signature = await signAndSendTransaction(transaction)\n\n      // Relay asserts base58 on submit and again on confirm, so a host that\n      // forwards its wallet's result unmapped has to fail here instead.\n      if (\n        !(signature instanceof Uint8Array) ||\n        signature.length !== SIGNATURE_BYTE_LENGTH\n      ) {\n        throw new Error(\n          `signAndSendTransaction must resolve a ${SIGNATURE_BYTE_LENGTH}-byte signature. The transaction may already have been submitted.`,\n        )\n      }\n\n      return { signature: bs58.encode(signature) }\n    }\n  }\n\n  throw new Error('Solana signer supplied no way to sign a transaction')\n}\n\n/** Matches `resolveSubmit`: `signTransaction` wins, and neither means it can't sign. */\nfunction resolveSigningMethod(\n  params: CreateSolanaAdapterParams,\n): FunkitSolanaAdapter['signingMethod'] {\n  if (params.signTransaction) {\n    return 'signTransaction'\n  }\n  if (params.signAndSendTransaction) {\n    return 'signAndSendTransaction'\n  }\n  return undefined\n}\n\n/**\n * Never throws, so hosts can call it during render. With no signing method\n * `signingMethod` is undefined, and funkit disables Solana flows instead of\n * calling `createRelayWallet()`, which would throw.\n */\nexport function createSolanaAdapter(\n  params: CreateSolanaAdapterParams,\n): FunkitSolanaAdapter {\n  return {\n    engine: 'web3',\n    address: params.address,\n    signingMethod: resolveSigningMethod(params),\n    createRelayWallet: () =>\n      adaptSolanaWallet(\n        params.address,\n        RELAY_SOLANA_CHAIN_ID_NUMBER,\n        params.connection,\n        resolveSubmit(params, params.connection),\n        params.payerKey,\n      ) as SolanaWallet,\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,uBAIO;AACP,sCAAkC;AAClC,kBAMO;AACP,kBAAiB;AAGjB,IAAM,wBAAwB;AA4C9B,SAAS,cACP,QACA,YACa;AAGb,QAAM,kBAAkB,OAAO,iBAAiB,KAAK,MAAM;AAC3D,QAAM,yBAAyB,OAAO,wBAAwB,KAAK,MAAM;AAGzE,MAAI,iBAAiB;AACnB,WAAO,OAAO,aAAa,YAAY;AACrC,YAAM,SAAS,MAAM,gBAAgB,WAAW;AAChD,UAAI;AACF,cAAM,YAAY,MAAM,WAAW,gBAAgB,QAAQ;AAAA,UACzD,GAAG;AAAA,UACH,YAAY;AAAA,QACd,CAAC;AAED,eAAO,EAAE,UAAU;AAAA,MACrB,SAAS,OAAO;AACd,YAAI,iBAAiB,kCAAsB;AACzC,kBAAQ;AAAA,YACN;AAAA,YACA;AAAA,YACA,MAAM,MAAM,QAAQ,UAAU,EAAE,MAAM,MAAM,MAAS;AAAA,UACvD;AAAA,QACF;AAEA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,MAAI,wBAAwB;AAC1B,WAAO,OAAO,gBAAgB;AAC5B,YAAM,YAAY,MAAM,uBAAuB,WAAW;AAI1D,UACE,EAAE,qBAAqB,eACvB,UAAU,WAAW,uBACrB;AACA,cAAM,IAAI;AAAA,UACR,yCAAyC,qBAAqB;AAAA,QAChE;AAAA,MACF;AAEA,aAAO,EAAE,WAAW,YAAAA,QAAK,OAAO,SAAS,EAAE;AAAA,IAC7C;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,qDAAqD;AACvE;AAGA,SAAS,qBACP,QACsC;AACtC,MAAI,OAAO,iBAAiB;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,wBAAwB;AACjC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,oBACd,QACqB;AACrB,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,SAAS,OAAO;AAAA,IAChB,eAAe,qBAAqB,MAAM;AAAA,IAC1C,mBAAmB,UACjB;AAAA,MACE,OAAO;AAAA,MACP;AAAA,MACA,OAAO;AAAA,MACP,cAAc,QAAQ,OAAO,UAAU;AAAA,MACvC,OAAO;AAAA,IACT;AAAA,EACJ;AACF;",
+  "names": ["bs58"]
+}

package/dist/index.mjs

@@ -0,0 +1,74 @@
+// src/solanaAdapter.ts
+import {
+  RELAY_SOLANA_CHAIN_ID_NUMBER
+} from "@funkit/fun-relay";
+import { adaptSolanaWallet } from "@relayprotocol/relay-svm-wallet-adapter";
+import {
+  SendTransactionError
+} from "@solana/web3.js";
+import bs58 from "bs58";
+var SIGNATURE_BYTE_LENGTH = 64;
+function resolveSubmit(signer, connection) {
+  const signTransaction = signer.signTransaction?.bind(signer);
+  const signAndSendTransaction = signer.signAndSendTransaction?.bind(signer);
+  if (signTransaction) {
+    return async (transaction, options) => {
+      const signed = await signTransaction(transaction);
+      try {
+        const signature = await connection.sendTransaction(signed, {
+          ...options,
+          maxRetries: 5
+        });
+        return { signature };
+      } catch (error) {
+        if (error instanceof SendTransactionError) {
+          console.error(
+            "Failed transaction logs:",
+            error,
+            await error.getLogs(connection).catch(() => void 0)
+          );
+        }
+        throw error;
+      }
+    };
+  }
+  if (signAndSendTransaction) {
+    return async (transaction) => {
+      const signature = await signAndSendTransaction(transaction);
+      if (!(signature instanceof Uint8Array) || signature.length !== SIGNATURE_BYTE_LENGTH) {
+        throw new Error(
+          `signAndSendTransaction must resolve a ${SIGNATURE_BYTE_LENGTH}-byte signature. The transaction may already have been submitted.`
+        );
+      }
+      return { signature: bs58.encode(signature) };
+    };
+  }
+  throw new Error("Solana signer supplied no way to sign a transaction");
+}
+function resolveSigningMethod(params) {
+  if (params.signTransaction) {
+    return "signTransaction";
+  }
+  if (params.signAndSendTransaction) {
+    return "signAndSendTransaction";
+  }
+  return void 0;
+}
+function createSolanaAdapter(params) {
+  return {
+    engine: "web3",
+    address: params.address,
+    signingMethod: resolveSigningMethod(params),
+    createRelayWallet: () => adaptSolanaWallet(
+      params.address,
+      RELAY_SOLANA_CHAIN_ID_NUMBER,
+      params.connection,
+      resolveSubmit(params, params.connection),
+      params.payerKey
+    )
+  };
+}
+export {
+  createSolanaAdapter
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/solanaAdapter.ts"],
+  "sourcesContent": ["import {\n  type FunkitSolanaAdapter,\n  RELAY_SOLANA_CHAIN_ID_NUMBER,\n  type SolanaWallet,\n} from '@funkit/fun-relay'\nimport { adaptSolanaWallet } from '@relayprotocol/relay-svm-wallet-adapter'\nimport {\n  type Connection,\n  type SendOptions,\n  SendTransactionError,\n  type TransactionSignature,\n  type VersionedTransaction,\n} from '@solana/web3.js'\nimport bs58 from 'bs58'\n\n/** Ed25519, so the transaction id is always these many bytes. */\nconst SIGNATURE_BYTE_LENGTH = 64\n\n/** The host's web3.js connection, used for blockhashes and funkit's own submits. */\nexport type SolanaConnection = Connection\n\n/** Signs and hands the transaction back, for funkit to submit. */\nexport type SolanaSignTransaction = (\n  transaction: VersionedTransaction,\n) => Promise<VersionedTransaction>\n\n/** Signs and submits, resolving the transaction's 64-byte signature. */\nexport type SolanaSignAndSendTransaction = (\n  transaction: VersionedTransaction,\n) => Promise<Uint8Array>\n\n/**\n * At least one of the two. `signTransaction` wins when both are supplied, since\n * submitting through funkit is what applies the rebroadcast retries and logs.\n */\nexport type SolanaSigner =\n  | {\n      signTransaction: SolanaSignTransaction\n      signAndSendTransaction?: SolanaSignAndSendTransaction\n    }\n  | {\n      signTransaction?: SolanaSignTransaction\n      signAndSendTransaction: SolanaSignAndSendTransaction\n    }\n\nexport type CreateSolanaAdapterParams = {\n  /** Base58 address of the connected wallet. funkit validates it, not this factory. */\n  address: string\n  /** Use an endpoint you trust for write traffic; public RPCs rate-limit. */\n  connection: SolanaConnection\n  /** Base58 fee payer when it isn't `address`, e.g. a sponsor that co-signs. */\n  payerKey?: string\n} & SolanaSigner\n\n/** Relay's submission hook: sign (or sign-and-send) and return the signature. */\ntype RelaySubmit = (\n  transaction: VersionedTransaction,\n  options?: SendOptions,\n) => Promise<{ signature: TransactionSignature }>\n\nfunction resolveSubmit(\n  signer: SolanaSigner,\n  connection: Connection,\n): RelaySubmit {\n  // Bound to the host's object: a class-based signer loses `this` when its\n  // methods are pulled off or spread.\n  const signTransaction = signer.signTransaction?.bind(signer)\n  const signAndSendTransaction = signer.signAndSendTransaction?.bind(signer)\n\n  // Submitting here is what applies the rebroadcast retries and failure logs.\n  if (signTransaction) {\n    return async (transaction, options) => {\n      const signed = await signTransaction(transaction)\n      try {\n        const signature = await connection.sendTransaction(signed, {\n          ...options,\n          maxRetries: 5,\n        })\n\n        return { signature }\n      } catch (error) {\n        if (error instanceof SendTransactionError) {\n          console.error(\n            'Failed transaction logs:',\n            error,\n            await error.getLogs(connection).catch(() => undefined),\n          )\n        }\n\n        throw error\n      }\n    }\n  }\n\n  if (signAndSendTransaction) {\n    return async (transaction) => {\n      const signature = await signAndSendTransaction(transaction)\n\n      // Relay asserts base58 on submit and again on confirm, so a host that\n      // forwards its wallet's result unmapped has to fail here instead.\n      if (\n        !(signature instanceof Uint8Array) ||\n        signature.length !== SIGNATURE_BYTE_LENGTH\n      ) {\n        throw new Error(\n          `signAndSendTransaction must resolve a ${SIGNATURE_BYTE_LENGTH}-byte signature. The transaction may already have been submitted.`,\n        )\n      }\n\n      return { signature: bs58.encode(signature) }\n    }\n  }\n\n  throw new Error('Solana signer supplied no way to sign a transaction')\n}\n\n/** Matches `resolveSubmit`: `signTransaction` wins, and neither means it can't sign. */\nfunction resolveSigningMethod(\n  params: CreateSolanaAdapterParams,\n): FunkitSolanaAdapter['signingMethod'] {\n  if (params.signTransaction) {\n    return 'signTransaction'\n  }\n  if (params.signAndSendTransaction) {\n    return 'signAndSendTransaction'\n  }\n  return undefined\n}\n\n/**\n * Never throws, so hosts can call it during render. With no signing method\n * `signingMethod` is undefined, and funkit disables Solana flows instead of\n * calling `createRelayWallet()`, which would throw.\n */\nexport function createSolanaAdapter(\n  params: CreateSolanaAdapterParams,\n): FunkitSolanaAdapter {\n  return {\n    engine: 'web3',\n    address: params.address,\n    signingMethod: resolveSigningMethod(params),\n    createRelayWallet: () =>\n      adaptSolanaWallet(\n        params.address,\n        RELAY_SOLANA_CHAIN_ID_NUMBER,\n        params.connection,\n        resolveSubmit(params, params.connection),\n        params.payerKey,\n      ) as SolanaWallet,\n  }\n}\n"],
+  "mappings": ";AAAA;AAAA,EAEE;AAAA,OAEK;AACP,SAAS,yBAAyB;AAClC;AAAA,EAGE;AAAA,OAGK;AACP,OAAO,UAAU;AAGjB,IAAM,wBAAwB;AA4C9B,SAAS,cACP,QACA,YACa;AAGb,QAAM,kBAAkB,OAAO,iBAAiB,KAAK,MAAM;AAC3D,QAAM,yBAAyB,OAAO,wBAAwB,KAAK,MAAM;AAGzE,MAAI,iBAAiB;AACnB,WAAO,OAAO,aAAa,YAAY;AACrC,YAAM,SAAS,MAAM,gBAAgB,WAAW;AAChD,UAAI;AACF,cAAM,YAAY,MAAM,WAAW,gBAAgB,QAAQ;AAAA,UACzD,GAAG;AAAA,UACH,YAAY;AAAA,QACd,CAAC;AAED,eAAO,EAAE,UAAU;AAAA,MACrB,SAAS,OAAO;AACd,YAAI,iBAAiB,sBAAsB;AACzC,kBAAQ;AAAA,YACN;AAAA,YACA;AAAA,YACA,MAAM,MAAM,QAAQ,UAAU,EAAE,MAAM,MAAM,MAAS;AAAA,UACvD;AAAA,QACF;AAEA,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,MAAI,wBAAwB;AAC1B,WAAO,OAAO,gBAAgB;AAC5B,YAAM,YAAY,MAAM,uBAAuB,WAAW;AAI1D,UACE,EAAE,qBAAqB,eACvB,UAAU,WAAW,uBACrB;AACA,cAAM,IAAI;AAAA,UACR,yCAAyC,qBAAqB;AAAA,QAChE;AAAA,MACF;AAEA,aAAO,EAAE,WAAW,KAAK,OAAO,SAAS,EAAE;AAAA,IAC7C;AAAA,EACF;AAEA,QAAM,IAAI,MAAM,qDAAqD;AACvE;AAGA,SAAS,qBACP,QACsC;AACtC,MAAI,OAAO,iBAAiB;AAC1B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,wBAAwB;AACjC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAOO,SAAS,oBACd,QACqB;AACrB,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,SAAS,OAAO;AAAA,IAChB,eAAe,qBAAqB,MAAM;AAAA,IAC1C,mBAAmB,MACjB;AAAA,MACE,OAAO;AAAA,MACP;AAAA,MACA,OAAO;AAAA,MACP,cAAc,QAAQ,OAAO,UAAU;AAAA,MACvC,OAAO;AAAA,IACT;AAAA,EACJ;AACF;",
+  "names": []
+}

package/dist/src/solanaAdapter.d.ts

@@ -0,0 +1,34 @@
+import { type FunkitSolanaAdapter } from '@funkit/fun-relay';
+import { type Connection, type VersionedTransaction } from '@solana/web3.js';
+/** The host's web3.js connection, used for blockhashes and funkit's own submits. */
+export type SolanaConnection = Connection;
+/** Signs and hands the transaction back, for funkit to submit. */
+export type SolanaSignTransaction = (transaction: VersionedTransaction) => Promise<VersionedTransaction>;
+/** Signs and submits, resolving the transaction's 64-byte signature. */
+export type SolanaSignAndSendTransaction = (transaction: VersionedTransaction) => Promise<Uint8Array>;
+/**
+ * At least one of the two. `signTransaction` wins when both are supplied, since
+ * submitting through funkit is what applies the rebroadcast retries and logs.
+ */
+export type SolanaSigner = {
+    signTransaction: SolanaSignTransaction;
+    signAndSendTransaction?: SolanaSignAndSendTransaction;
+} | {
+    signTransaction?: SolanaSignTransaction;
+    signAndSendTransaction: SolanaSignAndSendTransaction;
+};
+export type CreateSolanaAdapterParams = {
+    /** Base58 address of the connected wallet. funkit validates it, not this factory. */
+    address: string;
+    /** Use an endpoint you trust for write traffic; public RPCs rate-limit. */
+    connection: SolanaConnection;
+    /** Base58 fee payer when it isn't `address`, e.g. a sponsor that co-signs. */
+    payerKey?: string;
+} & SolanaSigner;
+/**
+ * Never throws, so hosts can call it during render. With no signing method
+ * `signingMethod` is undefined, and funkit disables Solana flows instead of
+ * calling `createRelayWallet()`, which would throw.
+ */
+export declare function createSolanaAdapter(params: CreateSolanaAdapterParams): FunkitSolanaAdapter;
+//# sourceMappingURL=solanaAdapter.d.ts.map

package/dist/src/solanaAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solanaAdapter.d.ts","sourceRoot":"","sources":["../../src/solanaAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAA;AAMxB,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAEzC,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG,CAClC,WAAW,EAAE,oBAAoB,KAC9B,OAAO,CAAC,oBAAoB,CAAC,CAAA;AAElC,wEAAwE;AACxE,MAAM,MAAM,4BAA4B,GAAG,CACzC,WAAW,EAAE,oBAAoB,KAC9B,OAAO,CAAC,UAAU,CAAC,CAAA;AAExB;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IACE,eAAe,EAAE,qBAAqB,CAAA;IACtC,sBAAsB,CAAC,EAAE,4BAA4B,CAAA;CACtD,GACD;IACE,eAAe,CAAC,EAAE,qBAAqB,CAAA;IACvC,sBAAsB,EAAE,4BAA4B,CAAA;CACrD,CAAA;AAEL,MAAM,MAAM,yBAAyB,GAAG;IACtC,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,UAAU,EAAE,gBAAgB,CAAA;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,YAAY,CAAA;AA6EhB;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,yBAAyB,GAChC,mBAAmB,CAcrB"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@funkit/solana-web3",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.0",
+  "description": "Runs funkit's Solana flows on a host's @solana/web3.js connection and wallet.",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.mjs",
+    "require": "./dist/index.js"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "funkit",
+    "relay",
+    "solana",
+    "web3.js"
+  ],
+  "author": "https://fun.xyz/",
+  "license": "MIT",
+  "dependencies": {
+    "@relayprotocol/relay-svm-wallet-adapter": "^22.0.2",
+    "bs58": "^6.0.0"
+  },
+  "peerDependencies": {
+    "@funkit/fun-relay": "^3.3.1",
+    "@relayprotocol/relay-sdk": "^8.0.2",
+    "@solana/web3.js": "~1.98.2"
+  },
+  "devDependencies": {
+    "@funkit/fun-relay": "3.3.1",
+    "@relayprotocol/relay-sdk": "^8.0.2",
+    "@solana/web3.js": "1.98.4",
+    "viem": "2.29.4",
+    "vitest": "^4.1.6"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fun-xyz/funkit.git",
+    "directory": "packages/solana-web3"
+  },
+  "homepage": "https://github.com/fun-xyz/funkit/tree/main/packages/solana-web3",
+  "scripts": {
+    "build": "node build.mjs && pnpm typecheck",
+    "build:watch": "node build.mjs --watch",
+    "dev": "pnpm build:watch & pnpm typegen:watch",
+    "prebuild": "rm -rf dist && pnpm typegen",
+    "typecheck": "pnpm tsrs --noEmit",
+    "typegen": "tsrs --project tsconfig.build.json --emitDeclarationOnly",
+    "typegen:watch": "tsrs --project tsconfig.build.json --emitDeclarationOnly --watch",
+    "lint": "oxlint",
+    "lint:fix": "oxlint --fix",
+    "test": "vitest"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.