stellar-contracts-kit 0.1.0

package/dist/index.js

@@ -0,0 +1,831 @@
+import { rpc, contract, Contract, SorobanDataBuilder, TransactionBuilder, BASE_FEE, Operation, xdr } from '@stellar/stellar-sdk';
+import freighter from '@stellar/freighter-api';
+import { isConnected, getPublicKey, signTransaction } from '@lobstrco/signer-extension-api';
+import { isExtensionInstalled, cyphras } from '@cyphras/sdk';
+
+// src/network/config.ts
+var NETWORKS = {
+  mainnet: {
+    rpcUrl: "https://mainnet.stellar.validationcloud.io/v1/soroban/rpc",
+    networkPassphrase: "Public Global Stellar Network ; September 2015",
+    horizonUrl: "https://horizon.stellar.org"
+  },
+  testnet: {
+    rpcUrl: "https://soroban-testnet.stellar.org",
+    networkPassphrase: "Test SDF Network ; September 2015",
+    horizonUrl: "https://horizon-testnet.stellar.org"
+  },
+  futurenet: {
+    rpcUrl: "https://rpc-futurenet.stellar.org",
+    networkPassphrase: "Test SDF Future Network ; October 2022",
+    horizonUrl: "https://horizon-futurenet.stellar.org"
+  }
+};
+function resolveNetwork(network) {
+  if (typeof network === "string") {
+    return NETWORKS[network];
+  }
+  return network;
+}
+function createServer(network) {
+  return new rpc.Server(network.rpcUrl, { allowHttp: network.rpcUrl.startsWith("http://") });
+}
+
+// src/errors/index.ts
+var StellarContractError = class extends Error {
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "StellarContractError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function makeError(code, message, cause) {
+  return new StellarContractError(code, message, cause);
+}
+function isContractKitError(err) {
+  return err instanceof StellarContractError;
+}
+
+// src/contract/spec.ts
+function validateContractId(id) {
+  if (!/^C[A-Z2-7]{55}$/.test(id)) {
+    throw makeError(
+      "INVALID_CONTRACT_ID",
+      `"${id}" is not a valid Soroban contract address. Expected a 56-character string starting with C (e.g. CABC...).`
+    );
+  }
+}
+async function fetchContractSpec(contractId, server, network) {
+  validateContractId(contractId);
+  let wasm;
+  try {
+    wasm = await server.getContractWasmByContractId(contractId);
+  } catch (err) {
+    throw makeError("CONTRACT_NOT_FOUND", `Contract ${contractId} not found or has no WASM`, err);
+  }
+  try {
+    const client = await contract.Client.fromWasm(wasm, {
+      contractId,
+      networkPassphrase: network.networkPassphrase,
+      rpcUrl: network.rpcUrl
+    });
+    return client.spec;
+  } catch (err) {
+    throw makeError("CONTRACT_SPEC_ERROR", `Failed to parse contract spec for ${contractId}`, err);
+  }
+}
+var TX_TIMEOUT_SECONDS = 300;
+function decodeSubmissionError(errorResult) {
+  if (!errorResult) return "unknown submission error";
+  try {
+    return errorResult.result().switch().name;
+  } catch {
+    return "unknown submission error";
+  }
+}
+function decodePollingError(pollRes) {
+  if (pollRes.status !== rpc.Api.GetTransactionStatus.FAILED) return "unknown";
+  try {
+    const resultXdr = pollRes.resultXdr;
+    if (!resultXdr) return "transaction failed";
+    const innerResults = resultXdr.result().results?.();
+    const opCode = innerResults?.[0]?.tr().invokeHostFunctionResult?.().switch().name;
+    return opCode ?? resultXdr.result().switch().name;
+  } catch {
+    return "transaction failed on-chain";
+  }
+}
+async function checkNetworkMatch(wallet, network) {
+  try {
+    const walletPassphrase = await wallet.getNetworkPassphrase();
+    if (walletPassphrase !== network.networkPassphrase) {
+      throw makeError(
+        "WALLET_NETWORK_MISMATCH",
+        `Wallet network mismatch. Wallet is on "${walletPassphrase}", kit is on "${network.networkPassphrase}". Switch your wallet to the correct network.`
+      );
+    }
+  } catch (err) {
+    if (isContractKitError(err) && err.code === "WALLET_NETWORK_MISMATCH") throw err;
+  }
+}
+async function buildTx(contractId, method, args, callerAddress, server, network) {
+  const account = await server.getAccount(callerAddress);
+  const contract2 = new Contract(contractId);
+  return new TransactionBuilder(account, {
+    fee: BASE_FEE,
+    networkPassphrase: network.networkPassphrase
+  }).addOperation(contract2.call(method, ...args)).setTimeout(TX_TIMEOUT_SECONDS).build();
+}
+async function finalizeTx(txHash, server) {
+  const pollRes = await server.pollTransaction(txHash, {
+    attempts: 20,
+    sleepStrategy: rpc.LinearSleepStrategy
+  });
+  if (pollRes.status === rpc.Api.GetTransactionStatus.FAILED) {
+    throw makeError("TX_FAILED", `Transaction failed on-chain: ${decodePollingError(pollRes)}`);
+  }
+  if (pollRes.status !== rpc.Api.GetTransactionStatus.SUCCESS) {
+    throw makeError("TX_TIMEOUT", `Transaction not confirmed after polling. Hash: ${txHash}`);
+  }
+  return { txHash, retval: pollRes.returnValue };
+}
+async function submitTx(simData, contractId, method, args, callerAddress, wallet, server, network) {
+  const { tx, rawSim } = simData;
+  const assembled = rpc.assembleTransaction(tx, rawSim).build();
+  const signedXdr = await wallet.signTransaction(assembled.toXDR(), {
+    networkPassphrase: network.networkPassphrase,
+    address: callerAddress
+  });
+  const freshAccount = await server.getAccount(callerAddress);
+  const refreshedTx = TransactionBuilder.fromXDR(signedXdr, network.networkPassphrase);
+  const expectedSeq = (BigInt(freshAccount.sequenceNumber()) + 1n).toString();
+  if (refreshedTx.sequence !== expectedSeq) {
+    const retryData = await runSimulate(contractId, method, args, callerAddress, server, network);
+    const retryAssembled = rpc.assembleTransaction(retryData.tx, retryData.rawSim).build();
+    const retrySignedXdr = await wallet.signTransaction(retryAssembled.toXDR(), {
+      networkPassphrase: network.networkPassphrase,
+      address: callerAddress
+    });
+    const retryTx = TransactionBuilder.fromXDR(retrySignedXdr, network.networkPassphrase);
+    const sendRetry = await server.sendTransaction(retryTx);
+    if (sendRetry.status === "ERROR") {
+      throw makeError("TX_SUBMISSION_FAILED", `Transaction failed after retry: ${decodeSubmissionError(sendRetry.errorResult)}`);
+    }
+    return finalizeTx(sendRetry.hash, server);
+  }
+  const sendRes = await server.sendTransaction(refreshedTx);
+  if (sendRes.status === "ERROR") {
+    throw makeError("TX_SUBMISSION_FAILED", `Transaction failed: ${decodeSubmissionError(sendRes.errorResult)}`);
+  }
+  return finalizeTx(sendRes.hash, server);
+}
+async function runSimulate(contractId, method, args, callerAddress, server, network) {
+  const tx = await buildTx(contractId, method, args, callerAddress, server, network);
+  const sim = await server.simulateTransaction(tx);
+  if (rpc.Api.isSimulationError(sim)) {
+    throw makeError("CONTRACT_SIMULATION_FAILED", `Simulation failed: ${sim.error}`);
+  }
+  if (rpc.Api.isSimulationRestore(sim)) {
+    throw makeError(
+      "CONTRACT_RESTORE_REQUIRED",
+      "Contract state has expired and needs to be restored. Call kit.restoreContract(contractId) first."
+    );
+  }
+  const retval = sim.result?.retval ?? xdr.ScVal.scvVoid();
+  const requiresAuth = (sim.result?.auth?.length ?? 0) > 0;
+  return {
+    result: { retval, requiresAuth },
+    tx,
+    rawSim: sim
+  };
+}
+async function simulateContract(contractId, method, args, callerAddress, server, network) {
+  const { result } = await runSimulate(contractId, method, args, callerAddress, server, network);
+  return result;
+}
+async function simulateContractFull(contractId, method, args, callerAddress, server, network) {
+  return runSimulate(contractId, method, args, callerAddress, server, network);
+}
+async function invokeContract(contractId, method, args, wallet, server, network, preSim) {
+  const callerAddress = await wallet.getAddress();
+  await checkNetworkMatch(wallet, network);
+  const simData = preSim ?? await runSimulate(contractId, method, args, callerAddress, server, network);
+  return submitTx(simData, contractId, method, args, callerAddress, wallet, server, network);
+}
+
+// src/contract/client.ts
+var NULL_ACCOUNT = "GAAZI4TCR3TY5OJHCTJC2A4QSY6CJWJH5IAJTGKIN2ER7LBNVKOCCWN";
+function positionedArgs(spec, methodName, args) {
+  const fn = spec.getFunc(methodName);
+  const inputs = fn.inputs();
+  if (args.length !== inputs.length) {
+    throw makeError(
+      "INVALID_PARAMS",
+      `${methodName}() expects ${inputs.length} argument(s), received ${args.length}.`
+    );
+  }
+  const named = {};
+  inputs.forEach((input, i) => {
+    named[input.name().toString()] = args[i] ?? null;
+  });
+  return named;
+}
+function decodeRetval(spec, methodName, retval) {
+  try {
+    return spec.funcResToNative(methodName, retval);
+  } catch {
+    return retval;
+  }
+}
+function buildContractClient(contractId, spec, wallet, server, network) {
+  const client = {};
+  for (const fn of spec.funcs()) {
+    const methodName = fn.name().toString();
+    const read = async (...args) => {
+      const callerAddress = wallet ? await wallet.getAddress() : NULL_ACCOUNT;
+      const named = positionedArgs(spec, methodName, args);
+      const scArgs = spec.funcArgsToScVals(methodName, named);
+      const sim = await simulateContract(contractId, methodName, scArgs, callerAddress, server, network);
+      return { result: decodeRetval(spec, methodName, sim.retval) };
+    };
+    const invoke = async (...args) => {
+      if (!wallet) throw makeError("WALLET_NOT_CONNECTED", "A wallet is required to invoke contract methods.");
+      const named = positionedArgs(spec, methodName, args);
+      const scArgs = spec.funcArgsToScVals(methodName, named);
+      const res = await invokeContract(contractId, methodName, scArgs, wallet, server, network);
+      return { txHash: res.txHash, result: res.retval ? decodeRetval(spec, methodName, res.retval) : void 0 };
+    };
+    const auto = async (...args) => {
+      const named = positionedArgs(spec, methodName, args);
+      const scArgs = spec.funcArgsToScVals(methodName, named);
+      const callerAddress = wallet ? await wallet.getAddress() : NULL_ACCOUNT;
+      const simData = await simulateContractFull(contractId, methodName, scArgs, callerAddress, server, network);
+      if (!simData.result.requiresAuth) {
+        return { result: decodeRetval(spec, methodName, simData.result.retval) };
+      }
+      if (!wallet) throw makeError("WALLET_NOT_CONNECTED", "A wallet is required to invoke this contract method.");
+      const res = await invokeContract(contractId, methodName, scArgs, wallet, server, network, simData);
+      return { txHash: res.txHash, result: res.retval ? decodeRetval(spec, methodName, res.retval) : void 0 };
+    };
+    client[methodName] = Object.assign(auto, { simulate: read, read, invoke });
+  }
+  return client;
+}
+var TX_TIMEOUT_SECONDS2 = 300;
+async function restoreContract(contractId, wallet, server, network) {
+  const callerAddress = await wallet.getAddress();
+  const account = await server.getAccount(callerAddress);
+  const contractObj = new Contract(contractId);
+  const sorobanData = new SorobanDataBuilder().setReadWrite([contractObj.getFootprint()]).build();
+  const tx = new TransactionBuilder(account, {
+    fee: BASE_FEE,
+    networkPassphrase: network.networkPassphrase
+  }).addOperation(Operation.restoreFootprint({})).setSorobanData(sorobanData).setTimeout(TX_TIMEOUT_SECONDS2).build();
+  const sim = await server.simulateTransaction(tx);
+  if (rpc.Api.isSimulationError(sim)) {
+    throw makeError("TX_SUBMISSION_FAILED", `Restore simulation failed: ${sim.error}`);
+  }
+  const assembled = rpc.assembleTransaction(tx, sim).build();
+  const signedXdr = await wallet.signTransaction(assembled.toXDR(), {
+    networkPassphrase: network.networkPassphrase,
+    address: callerAddress
+  });
+  const signedTx = TransactionBuilder.fromXDR(signedXdr, network.networkPassphrase);
+  const sendRes = await server.sendTransaction(signedTx);
+  if (sendRes.status === "ERROR") {
+    throw makeError("TX_SUBMISSION_FAILED", "Restore transaction submission failed");
+  }
+  const pollRes = await server.pollTransaction(sendRes.hash, {
+    attempts: 20,
+    sleepStrategy: rpc.LinearSleepStrategy
+  });
+  if (pollRes.status !== rpc.Api.GetTransactionStatus.SUCCESS) {
+    throw makeError("TX_FAILED", `Restore transaction failed on-chain. Hash: ${sendRes.hash}`);
+  }
+  return { txHash: sendRes.hash };
+}
+var FreighterAdapter = class {
+  constructor() {
+    this.name = "Freighter";
+    this.installUrl = "https://freighter.app";
+  }
+  async isAvailable() {
+    const res = await freighter.isConnected();
+    return !res.error && res.isConnected === true;
+  }
+  async connect() {
+    const res = await freighter.requestAccess();
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter access denied");
+    }
+    return { address: res.address };
+  }
+  async disconnect() {
+  }
+  async getAddress() {
+    const res = await freighter.getAddress();
+    if (res.error) {
+      throw makeError("WALLET_NOT_CONNECTED", res.error.message ?? "Could not get Freighter address");
+    }
+    return res.address;
+  }
+  async getNetworkPassphrase() {
+    const res = await freighter.getNetwork();
+    if (res.error) {
+      throw makeError("RPC_ERROR", res.error.message ?? "Could not get Freighter network");
+    }
+    return res.networkPassphrase;
+  }
+  async signTransaction(xdr2, opts) {
+    const signOpts = {
+      networkPassphrase: opts.networkPassphrase
+    };
+    if (opts.address !== void 0) signOpts.address = opts.address;
+    const res = await freighter.signTransaction(xdr2, signOpts);
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter rejected transaction signing");
+    }
+    return res.signedTxXdr;
+  }
+  async signAuthEntry(entryXdr, opts) {
+    const signOpts = {
+      networkPassphrase: opts.networkPassphrase
+    };
+    if (opts.address !== void 0) signOpts.address = opts.address;
+    const res = await freighter.signAuthEntry(entryXdr, signOpts);
+    if (res.error) {
+      throw makeError("WALLET_REJECTED", res.error.message ?? "Freighter rejected auth entry signing");
+    }
+    if (!res.signedAuthEntry) {
+      throw makeError("WALLET_REJECTED", "Freighter returned null auth entry");
+    }
+    return res.signedAuthEntry;
+  }
+};
+var LobstrAdapter = class {
+  constructor() {
+    this.name = "Lobstr";
+    this.installUrl = "https://lobstr.co/";
+  }
+  async isAvailable() {
+    if (typeof window === "undefined") return false;
+    if (window.lobstrSignerExtension) return true;
+    return Promise.race([
+      isConnected(),
+      new Promise((res) => setTimeout(() => res(false), 500))
+    ]);
+  }
+  async connect() {
+    try {
+      const address = await getPublicKey();
+      return { address };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (msg.toLowerCase().includes("reject") || msg.toLowerCase().includes("denied") || msg.toLowerCase().includes("cancel")) {
+        throw makeError("WALLET_REJECTED", "Lobstr connection was rejected by the user");
+      }
+      throw makeError("WALLET_REJECTED", `Lobstr connection failed: ${msg}`, err);
+    }
+  }
+  async disconnect() {
+  }
+  async getAddress() {
+    try {
+      return await getPublicKey();
+    } catch (err) {
+      throw makeError("WALLET_NOT_CONNECTED", "Could not retrieve Lobstr public key. Make sure the wallet is connected.", err);
+    }
+  }
+  async getNetworkPassphrase() {
+    throw makeError(
+      "RPC_ERROR",
+      "Lobstr does not expose network info. Ensure your Lobstr extension is set to the same network as your kit config."
+    );
+  }
+  async signTransaction(xdr2, _opts) {
+    try {
+      return await signTransaction(xdr2);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      if (msg.toLowerCase().includes("reject") || msg.toLowerCase().includes("denied") || msg.toLowerCase().includes("cancel")) {
+        throw makeError("WALLET_REJECTED", "Lobstr rejected transaction signing");
+      }
+      throw makeError("WALLET_REJECTED", `Lobstr signing failed: ${msg}`, err);
+    }
+  }
+  async signAuthEntry(_entryXdr, _opts) {
+    throw makeError(
+      "WALLET_REJECTED",
+      "Lobstr does not support signing individual auth entries. For multi-party auth contracts, use Freighter."
+    );
+  }
+};
+function toKitError(err) {
+  const c = err.code;
+  const m = err.message;
+  if (c === "REJECTED" || c === "USER_REJECTED") throw makeError("WALLET_REJECTED", m);
+  if (c === "TIMEOUT") throw makeError("TX_TIMEOUT", m);
+  if (c === "NETWORK_MISMATCH") throw makeError("WALLET_NETWORK_MISMATCH", m);
+  if (c === "UNAUTHORIZED" || c === "NOT_ALLOWED" || c === "NOT_CONNECTED" || c === "WALLET_LOCKED") {
+    throw makeError("WALLET_NOT_CONNECTED", m);
+  }
+  throw makeError("RPC_ERROR", m);
+}
+var CyphrasAdapter = class {
+  constructor() {
+    this.name = "Cyphras";
+    this.installUrl = "https://cyphras.com";
+  }
+  isAvailable() {
+    return isExtensionInstalled();
+  }
+  async connect() {
+    if (!isExtensionInstalled()) throw makeError("WALLET_NOT_FOUND", "Cyphras extension is not installed");
+    const res = await cyphras.stellar.connect();
+    if (res.error) toKitError(res.error);
+    return { address: res.address };
+  }
+  async disconnect() {
+    if (!isExtensionInstalled()) return;
+    await cyphras.stellar.disconnect();
+  }
+  async getAddress() {
+    const res = await cyphras.stellar.getAccount();
+    if (res.error) toKitError(res.error);
+    return res.address;
+  }
+  async getNetworkPassphrase() {
+    const res = await cyphras.stellar.getNetwork();
+    if (res.error) toKitError(res.error);
+    return res.networkPassphrase;
+  }
+  async signTransaction(xdr2, _opts) {
+    const res = await cyphras.stellar.sign(xdr2);
+    if (res.error) toKitError(res.error);
+    return res.signedTxXdr;
+  }
+  async signAuthEntry(entryXdr, opts) {
+    const res = await cyphras.stellar.sign(entryXdr, {
+      type: "authEntry",
+      networkPassphrase: opts.networkPassphrase
+    });
+    if (res.error) toKitError(res.error);
+    return res.signedAuthEntry;
+  }
+};
+
+// src/wallets/icons.ts
+var FREIGHTER_ICON = '<img src="data:image/png;base64,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" style="display:block;width:100%;height:100%">';
+var LOBSTR_ICON = `<svg viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="24" height="24" rx="6" fill="url(#_sck_lg)"/><g clip-path="url(#_sck_lc)"><path d="M12.0487 17.52C9.15226 17.52 7.12891 15.7429 7.12891 13.1983C7.12891 10.79 9.87935 6.8289 12.9852 6C12.281 6.70257 11.3136 7.76163 10.774 8.91785C10.0088 10.5569 9.93647 13.059 10.0033 13.353L10.1113 13.8275L10.5704 13.6503C11.066 13.4589 11.5442 13.1829 11.9916 12.8297C12.1583 12.6975 12.3221 12.5537 12.4778 12.4023C12.5845 12.2985 12.6877 12.1909 12.7876 12.0804C13.7724 10.9876 14.4034 9.57288 14.5054 8.30033C15.9075 9.2364 16.9689 11.2795 16.9689 13.1983C16.9689 15.7429 14.9456 17.52 12.0487 17.52Z" fill="white"/></g><defs><linearGradient id="_sck_lg" x1="12" y1="0" x2="12" y2="24" gradientUnits="userSpaceOnUse"><stop stop-color="#5CB3CB"/><stop offset="1" stop-color="#4594AF"/></linearGradient><clipPath id="_sck_lc"><rect width="11.52" height="11.52" fill="white" transform="translate(6 6)"/></clipPath></defs></svg>`;
+var CYPHRAS_ICON = `<svg viewBox="0 0 1620 1620" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="1620" height="1620" fill="#009FE1"/><path d="M713.184 848.184C692.095 827.095 692.095 792.905 713.184 771.816L771.816 713.184C792.905 692.095 827.095 692.095 848.184 713.184L906.816 771.816C927.905 792.905 927.905 827.095 906.816 848.184L848.184 906.816C827.095 927.905 792.905 927.905 771.816 906.816L713.184 848.184Z" fill="white"/><path d="M810 270C1077.57 270 1299.68 464.606 1342.53 720H1064.64C1027.57 615.133 927.56 540 810 540C660.883 540 540 660.883 540 810C540 959.117 660.883 1080 810 1080C927.56 1080 1027.57 1004.87 1064.64 900H1342.53C1299.68 1155.39 1077.57 1350 810 1350C511.766 1350 270 1108.23 270 810C270 511.766 511.766 270 810 270Z" fill="white"/></svg>`;
+
+// src/wallets/modal.ts
+var WALLETS = [
+  {
+    id: "freighter",
+    name: "Freighter",
+    description: "Stellar Development Foundation",
+    createAdapter: () => new FreighterAdapter(),
+    installUrl: "https://freighter.app",
+    icon: FREIGHTER_ICON
+  },
+  {
+    id: "cyphras",
+    name: "Cyphras",
+    description: "Cyphras Wallet",
+    createAdapter: () => new CyphrasAdapter(),
+    installUrl: "https://cyphras.com",
+    icon: CYPHRAS_ICON
+  },
+  {
+    id: "lobstr",
+    name: "Lobstr",
+    description: "LOBSTR",
+    createAdapter: () => new LobstrAdapter(),
+    installUrl: "https://lobstr.co/",
+    icon: LOBSTR_ICON
+  }
+];
+var STYLE_ID = "__stellar_contracts_kit_styles__";
+var CSS = `
+  @keyframes _sck_fade{from{opacity:0}to{opacity:1}}
+  @keyframes _sck_up{from{opacity:0;transform:translateY(12px)}to{opacity:1;transform:translateY(0)}}
+  @keyframes _sck_spin{to{transform:rotate(360deg)}}
+  ._sck_overlay{
+    position:fixed;inset:0;z-index:2147483647;
+    display:flex;align-items:center;justify-content:center;
+    background:rgba(0,0,0,.48);backdrop-filter:blur(8px);
+    animation:_sck_fade .15s ease;
+    font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Helvetica,Arial,sans-serif;
+  }
+
+  ._sck_card{
+    background:#fff;border-radius:24px;width:min(380px,92vw);
+    box-shadow:0 24px 64px rgba(0,0,0,.18),0 2px 8px rgba(0,0,0,.06);
+    animation:_sck_up .2s cubic-bezier(.16,1,.3,1);
+    overflow:hidden;
+  }
+
+  ._sck_head{
+    display:flex;align-items:center;justify-content:space-between;
+    padding:20px 20px 0;
+  }
+
+  ._sck_title{font-size:16px;font-weight:700;color:#111;letter-spacing:-.3px}
+
+  ._sck_close{
+    width:28px;height:28px;border-radius:50%;border:none;cursor:pointer;
+    background:#f0f0f0;color:#777;padding:0;
+    display:flex;align-items:center;justify-content:center;
+    transition:background .12s,color .12s;flex-shrink:0;
+  }
+  ._sck_close:hover{background:#e3e3e3;color:#111}
+  ._sck_close svg{display:block}
+
+  ._sck_list{padding:12px 8px 10px;display:flex;flex-direction:column;gap:2px}
+
+  ._sck_item{
+    display:flex;align-items:center;gap:12px;
+    padding:10px 12px;border-radius:14px;
+    cursor:pointer;transition:background .1s;
+    background:transparent;width:100%;text-align:left;
+    border:none;outline:none;
+  }
+  ._sck_item:hover{background:#f5f5f5}
+  ._sck_item:focus-visible{outline:2px solid #3b82f6;outline-offset:1px}
+  ._sck_item._sck_connecting{pointer-events:none}
+  ._sck_item._sck_error{background:#fef2f2}
+
+  ._sck_icon{
+    width:44px;height:44px;border-radius:12px;overflow:hidden;
+    flex-shrink:0;background:#f5f5f5;
+  }
+  ._sck_icon img,._sck_icon svg{width:100%;height:100%;display:block}
+
+  ._sck_meta{flex:1;min-width:0}
+  ._sck_name{font-size:15px;font-weight:600;color:#111;line-height:1.3}
+  ._sck_sub{font-size:12px;color:#aaa;margin-top:1px}
+  ._sck_errmsg{font-size:11px;color:#dc2626;margin-top:3px;line-height:1.4}
+
+  ._sck_right{
+    width:80px;display:flex;align-items:center;
+    justify-content:flex-end;flex-shrink:0;
+  }
+
+  ._sck_install{
+    display:inline-flex;align-items:center;gap:5px;
+    font-size:12px;font-weight:500;color:#aaa;
+    text-decoration:none;transition:color .12s;white-space:nowrap;
+  }
+  ._sck_install:hover{color:#555}
+  ._sck_install svg{display:block;flex-shrink:0}
+
+  ._sck_spinner{
+    width:18px;height:18px;border-radius:50%;
+    border:2.5px solid #e0e0e0;border-top-color:#444;
+    animation:_sck_spin .7s linear infinite;
+  }
+
+  ._sck_foot{
+    padding:10px 20px 16px;text-align:center;
+    font-size:11px;color:#d0d0d0;border-top:1px solid #f2f2f2;margin-top:4px;
+    letter-spacing:.2px;
+  }
+`;
+function injectStyles() {
+  if (typeof document === "undefined" || document.getElementById(STYLE_ID)) return;
+  const el = document.createElement("style");
+  el.id = STYLE_ID;
+  el.textContent = CSS;
+  document.head.appendChild(el);
+}
+function buildItem(def, onConnect) {
+  const el = document.createElement("button");
+  el.className = "_sck_item";
+  el.type = "button";
+  const iconWrap = document.createElement("div");
+  iconWrap.className = "_sck_icon";
+  iconWrap.innerHTML = def.icon;
+  const meta = document.createElement("div");
+  meta.className = "_sck_meta";
+  const name = document.createElement("div");
+  name.className = "_sck_name";
+  name.textContent = def.name;
+  const sub = document.createElement("div");
+  sub.className = "_sck_sub";
+  sub.textContent = def.description;
+  const errEl = document.createElement("div");
+  errEl.className = "_sck_errmsg";
+  errEl.style.display = "none";
+  meta.append(name, sub, errEl);
+  const right = document.createElement("div");
+  right.className = "_sck_right";
+  el.append(iconWrap, meta, right);
+  let avail = "checking";
+  el.addEventListener("click", () => {
+    if (avail === "checking") return;
+    if (avail === "no") {
+      window.open(def.installUrl, "_blank", "noopener,noreferrer");
+      return;
+    }
+    onConnect(def);
+  });
+  function renderRight() {
+    right.innerHTML = "";
+    errEl.style.display = "none";
+    if (avail === "checking") ; else if (avail === "yes") ; else {
+      const link = document.createElement("a");
+      link.className = "_sck_install";
+      link.href = def.installUrl;
+      link.target = "_blank";
+      link.rel = "noopener noreferrer";
+      link.innerHTML = 'Install<svg xmlns="http://www.w3.org/2000/svg" width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h6"/><path d="m21 3-9 9"/><path d="M15 3h6v6"/></svg>';
+      link.addEventListener("click", (e) => e.stopPropagation());
+      right.appendChild(link);
+    }
+  }
+  function setAvail(state) {
+    avail = state;
+    el.classList.remove("_sck_connecting", "_sck_error");
+    renderRight();
+  }
+  function setConnecting(loading, errorMsg) {
+    if (loading) {
+      el.classList.add("_sck_connecting");
+      el.classList.remove("_sck_error");
+      right.innerHTML = "";
+      const spinner = document.createElement("div");
+      spinner.className = "_sck_spinner";
+      right.appendChild(spinner);
+      errEl.style.display = "none";
+    } else if (errorMsg !== void 0) {
+      el.classList.remove("_sck_connecting");
+      el.classList.add("_sck_error");
+      errEl.textContent = errorMsg;
+      errEl.style.display = "block";
+      renderRight();
+    } else {
+      el.classList.remove("_sck_connecting", "_sck_error");
+      renderRight();
+    }
+  }
+  return { el, setAvail, setConnecting };
+}
+var WalletPickerModal = class {
+  constructor() {
+    this.overlay = null;
+    this.onKeydown = null;
+  }
+  async pick() {
+    if (typeof document === "undefined") {
+      throw new Error("WalletPickerModal requires a browser environment.");
+    }
+    injectStyles();
+    return new Promise((resolve, reject) => {
+      const itemUIs = this.render(resolve, reject);
+      for (const def of WALLETS) {
+        const ui = itemUIs.get(def.id);
+        Promise.resolve(def.createAdapter().isAvailable()).then((ok) => ui.setAvail(ok ? "yes" : "no")).catch(() => ui.setAvail("no"));
+      }
+    });
+  }
+  render(resolve, reject) {
+    const overlay = document.createElement("div");
+    overlay.className = "_sck_overlay";
+    overlay.setAttribute("role", "dialog");
+    overlay.setAttribute("aria-modal", "true");
+    overlay.setAttribute("aria-label", "Connect Wallet");
+    this.overlay = overlay;
+    const card = document.createElement("div");
+    card.className = "_sck_card";
+    card.addEventListener("click", (e) => e.stopPropagation());
+    const head = document.createElement("div");
+    head.className = "_sck_head";
+    const title = document.createElement("div");
+    title.className = "_sck_title";
+    title.textContent = "Connect Wallet";
+    const closeBtn = document.createElement("button");
+    closeBtn.className = "_sck_close";
+    closeBtn.setAttribute("aria-label", "Close");
+    closeBtn.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>';
+    closeBtn.addEventListener("click", () => this.dismiss(reject));
+    head.append(title, closeBtn);
+    const list = document.createElement("div");
+    list.className = "_sck_list";
+    const itemUIs = /* @__PURE__ */ new Map();
+    for (const def of WALLETS) {
+      const item = buildItem(def, async (clickedDef) => {
+        const ui = itemUIs.get(clickedDef.id);
+        itemUIs.forEach((other, id) => {
+          if (id !== clickedDef.id) {
+            other.el.style.opacity = "0.3";
+            other.el.style.pointerEvents = "none";
+          }
+        });
+        ui.setConnecting(true);
+        try {
+          const adapter = clickedDef.createAdapter();
+          const { address } = await adapter.connect();
+          this.close();
+          resolve({ adapter, address });
+        } catch (err) {
+          itemUIs.forEach((other) => {
+            other.el.style.opacity = "";
+            other.el.style.pointerEvents = "";
+          });
+          let msg = "Connection failed. Try again.";
+          if (isContractKitError(err)) {
+            msg = err.code === "WALLET_REJECTED" ? "Connection rejected." : err.message;
+          } else if (err instanceof Error) {
+            msg = err.message;
+          }
+          ui.setConnecting(false, msg);
+        }
+      });
+      itemUIs.set(def.id, item);
+      list.appendChild(item.el);
+    }
+    const foot = document.createElement("div");
+    foot.className = "_sck_foot";
+    foot.textContent = "stellar-contracts-kit";
+    card.append(head, list, foot);
+    overlay.appendChild(card);
+    document.body.appendChild(overlay);
+    overlay.addEventListener("click", () => this.dismiss(reject));
+    this.onKeydown = (e) => {
+      if (e.key === "Escape") this.dismiss(reject);
+    };
+    document.addEventListener("keydown", this.onKeydown);
+    list.querySelector("._sck_item")?.focus();
+    return itemUIs;
+  }
+  close() {
+    this.overlay?.remove();
+    this.overlay = null;
+    if (this.onKeydown) {
+      document.removeEventListener("keydown", this.onKeydown);
+      this.onKeydown = null;
+    }
+  }
+  dismiss(reject) {
+    this.close();
+    reject(new Error("Wallet selection was dismissed"));
+  }
+};
+
+// src/kit.ts
+var StellarContractsKit = class {
+  constructor(options) {
+    this.specCache = /* @__PURE__ */ new Map();
+    this.network = resolveNetwork(options.network);
+    this.server = createServer(this.network);
+    this.wallet = options.wallet ?? null;
+  }
+  setWallet(wallet) {
+    this.wallet = wallet;
+  }
+  /** Returns the active wallet adapter, or null if none is set. */
+  getWallet() {
+    return this.wallet;
+  }
+  /** Connects to the configured wallet, or opens the built-in picker modal if none is set. */
+  async connect() {
+    if (this.wallet) {
+      return this.wallet.connect();
+    }
+    const modal = new WalletPickerModal();
+    const { adapter, address } = await modal.pick();
+    this.wallet = adapter;
+    return { address };
+  }
+  /** Disconnects the current wallet and clears the active adapter. */
+  async disconnect() {
+    await this.wallet?.disconnect();
+    this.wallet = null;
+  }
+  isConnected() {
+    return this.wallet !== null;
+  }
+  /** Returns the address of the connected wallet. Throws WALLET_NOT_CONNECTED if no wallet is set. */
+  async getAddress() {
+    if (!this.wallet) throw makeError("WALLET_NOT_CONNECTED", "No wallet connected. Call connect() first.");
+    return this.wallet.getAddress();
+  }
+  getNetwork() {
+    return this.network;
+  }
+  /**
+   * Loads a typed contract client. Pass a generated interface as the type param for full autocomplete.
+   * No wallet required for read/simulate calls. A wallet is required before calling invoke.
+   * The spec is fetched once and cached; subsequent calls with the same ID are instant.
+   */
+  async contract(contractId) {
+    let spec = this.specCache.get(contractId);
+    if (!spec) {
+      spec = await fetchContractSpec(contractId, this.server, this.network);
+      this.specCache.set(contractId, spec);
+    }
+    return buildContractClient(contractId, spec, this.wallet, this.server, this.network);
+  }
+  /**
+   * Restores an expired contract's on-chain state.
+   * Call this when contract() or invoke() throws CONTRACT_RESTORE_REQUIRED.
+   */
+  async restoreContract(contractId) {
+    if (!this.wallet) throw makeError("WALLET_NOT_CONNECTED", "A wallet is required to restore a contract.");
+    const result = await restoreContract(contractId, this.wallet, this.server, this.network);
+    this.clearSpecCache(contractId);
+    return result;
+  }
+  /** Clears the cached contract spec. Pass a contractId to clear one, or omit to clear all. */
+  clearSpecCache(contractId) {
+    if (contractId) {
+      this.specCache.delete(contractId);
+    } else {
+      this.specCache.clear();
+    }
+  }
+};
+
+export { CyphrasAdapter, FreighterAdapter, LobstrAdapter, NETWORKS, StellarContractError, StellarContractsKit, WalletPickerModal, isContractKitError };