moneyos 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -0,0 +1,720 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  EOAExecutor: () => EOAExecutor,
+  FileKeyStore: () => FileKeyStore,
+  LocalAccessAdapter: () => LocalAccessAdapter,
+  MoneyOS: () => MoneyOS,
+  NATIVE_TOKEN_ADDRESS: () => NATIVE_TOKEN_ADDRESS,
+  OdosProvider: () => OdosProvider,
+  ViemReadClient: () => ViemReadClient,
+  chains: () => chains,
+  createMoneyOS: () => createMoneyOS,
+  defaultChain: () => defaultChain,
+  getChain: () => getChain,
+  getToken: () => getToken,
+  getTokenAddress: () => getTokenAddress,
+  tokens: () => tokens
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/core/client.ts
+var import_viem4 = require("viem");
+
+// packages/core/dist/index.js
+var NATIVE_TOKEN_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+var tokens = {
+  ETH: {
+    symbol: "ETH",
+    name: "Ether",
+    decimals: 18,
+    addresses: {
+      42161: NATIVE_TOKEN_ADDRESS,
+      1: NATIVE_TOKEN_ADDRESS
+    }
+  },
+  POL: {
+    symbol: "POL",
+    name: "POL",
+    decimals: 18,
+    addresses: {
+      137: NATIVE_TOKEN_ADDRESS
+    }
+  },
+  USDC: {
+    symbol: "USDC",
+    name: "USD Coin",
+    decimals: 6,
+    addresses: {
+      42161: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+      1: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+      137: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"
+    }
+  },
+  USDT: {
+    symbol: "USDT",
+    name: "Tether USD",
+    decimals: 6,
+    addresses: {
+      42161: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+      1: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+      137: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
+    }
+  },
+  RYZE: {
+    symbol: "RYZE",
+    name: "RYZE",
+    decimals: 18,
+    addresses: {
+      42161: "0x7712da72127d5dD213B621497D6E4899d5989e5C"
+    }
+  }
+};
+function getToken(symbol) {
+  return tokens[symbol.toUpperCase()];
+}
+function getTokenAddress(symbol, chainId) {
+  return getToken(symbol)?.addresses[chainId];
+}
+var chains = {
+  arbitrum: {
+    id: 42161,
+    name: "Arbitrum One",
+    rpcUrl: "https://arb1.arbitrum.io/rpc",
+    nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+    blockExplorer: "https://arbiscan.io"
+  },
+  ethereum: {
+    id: 1,
+    name: "Ethereum",
+    rpcUrl: "https://eth.public-rpc.com",
+    nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+    blockExplorer: "https://etherscan.io"
+  },
+  polygon: {
+    id: 137,
+    name: "Polygon",
+    rpcUrl: "https://polygon-rpc.com",
+    nativeCurrency: { name: "POL", symbol: "POL", decimals: 18 },
+    blockExplorer: "https://polygonscan.com"
+  }
+};
+var defaultChain = chains.arbitrum;
+function getChain(idOrName) {
+  if (typeof idOrName === "number") {
+    return Object.values(chains).find((c) => c.id === idOrName);
+  }
+  return chains[idOrName.toLowerCase()];
+}
+
+// src/core/eoa.ts
+var import_viem2 = require("viem");
+var import_chains = require("viem/chains");
+
+// src/core/signer.ts
+var import_viem = require("viem");
+var import_accounts = require("viem/accounts");
+function privateKeyToManagedAccount(privateKey) {
+  return (0, import_accounts.privateKeyToAccount)(privateKey, { nonceManager: import_viem.nonceManager });
+}
+
+// src/core/eoa.ts
+var viemChainMap = {
+  42161: import_chains.arbitrum,
+  1: import_chains.mainnet,
+  137: import_chains.polygon
+};
+function getViemChain(chainId) {
+  return viemChainMap[chainId];
+}
+var ViemReadClient = class {
+  clients = /* @__PURE__ */ new Map();
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  getClient(chainId) {
+    let client = this.clients.get(chainId);
+    if (!client) {
+      const chain = getViemChain(chainId);
+      const chainInfo = getChain(chainId);
+      const rpcUrl = chainId === this.config.defaultChainId ? this.config.rpcUrl : void 0;
+      client = (0, import_viem2.createPublicClient)({
+        chain,
+        transport: (0, import_viem2.http)(rpcUrl ?? chainInfo?.rpcUrl)
+      });
+      this.clients.set(chainId, client);
+    }
+    return client;
+  }
+  async getBalance(params) {
+    const client = this.getClient(params.chainId);
+    return client.getBalance({ address: params.address });
+  }
+  async readContract(params) {
+    const client = this.getClient(params.chainId);
+    return client.readContract({
+      address: params.address,
+      abi: params.abi,
+      functionName: params.functionName,
+      args: params.args
+    });
+  }
+};
+var EOAExecutor = class _EOAExecutor {
+  mode = "eoa";
+  signer;
+  walletClients = /* @__PURE__ */ new Map();
+  publicClients = /* @__PURE__ */ new Map();
+  config;
+  constructor(signer, config) {
+    this.signer = signer;
+    this.config = config;
+  }
+  /**
+   * Convenience factory: build an EOAExecutor from a raw private key.
+   * Equivalent to `new EOAExecutor(privateKeyToAccount(privateKey), config)`.
+   * Kept as a helper so the common "I have a hex key" path stays one line
+   * while the constructor itself takes a viem `Account` to accommodate
+   * future keystore-backed signers (hardware, KMS, MPC).
+   *
+   * Attach viem's nonce manager so back-to-back live transactions use a
+   * pending-aware nonce source instead of relying on RPC fill behavior.
+   */
+  static fromPrivateKey(privateKey, config) {
+    return new _EOAExecutor(privateKeyToManagedAccount(privateKey), config);
+  }
+  getWalletClient(chainId) {
+    let client = this.walletClients.get(chainId);
+    if (!client) {
+      const chain = getViemChain(chainId);
+      const chainInfo = getChain(chainId);
+      const rpcUrl = chainId === this.config.defaultChainId ? this.config.rpcUrl : void 0;
+      client = (0, import_viem2.createWalletClient)({
+        account: this.signer,
+        chain,
+        transport: (0, import_viem2.http)(rpcUrl ?? chainInfo?.rpcUrl)
+      });
+      this.walletClients.set(chainId, client);
+    }
+    return client;
+  }
+  getPublicClient(chainId) {
+    let client = this.publicClients.get(chainId);
+    if (!client) {
+      const chain = getViemChain(chainId);
+      const chainInfo = getChain(chainId);
+      const rpcUrl = chainId === this.config.defaultChainId ? this.config.rpcUrl : void 0;
+      client = (0, import_viem2.createPublicClient)({
+        chain,
+        transport: (0, import_viem2.http)(rpcUrl ?? chainInfo?.rpcUrl)
+      });
+      this.publicClients.set(chainId, client);
+    }
+    return client;
+  }
+  getAddress() {
+    return this.signer.address;
+  }
+  async send(call) {
+    const walletClient = this.getWalletClient(call.chainId);
+    const hash = await walletClient.sendTransaction({
+      account: walletClient.account,
+      to: call.to,
+      data: call.data,
+      value: call.value ?? 0n,
+      chain: walletClient.chain
+    });
+    const publicClient = this.getPublicClient(call.chainId);
+    const receipt = await publicClient.waitForTransactionReceipt({ hash });
+    if (receipt.status !== "success") {
+      throw new Error(
+        `Transaction ${hash} reverted on chain ${call.chainId} (block ${receipt.blockNumber}).`
+      );
+    }
+    return { hash, chainId: call.chainId };
+  }
+  capabilities() {
+    return {
+      sponsoredGas: false,
+      batching: false,
+      simulation: false
+    };
+  }
+};
+
+// src/tools/swap.ts
+var import_viem3 = require("viem");
+var ERC20_ABI = [
+  {
+    name: "approve",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "spender", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    name: "allowance",
+    type: "function",
+    stateMutability: "view",
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" }
+    ],
+    outputs: [{ name: "", type: "uint256" }]
+  }
+];
+async function executeSwap(input, ctx) {
+  const { tokenIn, tokenOut, amount, provider, chainId, slippage } = input;
+  const { read, execute, assets } = ctx;
+  const sender = execute.getAddress();
+  const tokenInAddress = assets.getTokenAddress(tokenIn, chainId);
+  const tokenOutAddress = assets.getTokenAddress(tokenOut, chainId);
+  if (!tokenInAddress) {
+    throw new Error(`Token ${tokenIn} not found on chain ${chainId}`);
+  }
+  if (!tokenOutAddress) {
+    throw new Error(`Token ${tokenOut} not found on chain ${chainId}`);
+  }
+  const tokenInInfo = assets.getToken(tokenIn);
+  const amountWei = (0, import_viem3.parseUnits)(amount, tokenInInfo.decimals);
+  const quote = await provider.getQuote({
+    chainId,
+    tokenIn: tokenInAddress,
+    tokenOut: tokenOutAddress,
+    amount: amountWei,
+    sender,
+    slippage
+  });
+  const calldata = await provider.getCalldata(quote);
+  const isNativeIn = tokenInAddress === assets.nativeTokenAddress;
+  if (!isNativeIn) {
+    const currentAllowance = await read.readContract({
+      address: tokenInAddress,
+      abi: ERC20_ABI,
+      functionName: "allowance",
+      args: [sender, calldata.to],
+      chainId
+    });
+    if (currentAllowance < amountWei) {
+      const approveData = (0, import_viem3.encodeFunctionData)({
+        abi: ERC20_ABI,
+        functionName: "approve",
+        args: [calldata.to, amountWei]
+      });
+      await execute.send({ to: tokenInAddress, data: approveData, chainId });
+    }
+  }
+  const result = await execute.send({
+    to: calldata.to,
+    data: calldata.data,
+    value: isNativeIn ? amountWei : calldata.value,
+    chainId
+  });
+  const tokenOutInfo = assets.getToken(tokenOut);
+  return {
+    hash: result.hash,
+    tokenIn: tokenInInfo.symbol,
+    tokenOut: tokenOutInfo.symbol,
+    amountIn: amount,
+    amountOut: (0, import_viem3.formatUnits)(BigInt(quote.expectedOut), tokenOutInfo.decimals),
+    chainId
+  };
+}
+
+// src/core/client.ts
+var ERC20_ABI2 = [
+  {
+    name: "balanceOf",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }]
+  },
+  {
+    name: "transfer",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: [{ name: "", type: "bool" }]
+  },
+  {
+    name: "decimals",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "uint8" }]
+  },
+  {
+    name: "symbol",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ name: "", type: "string" }]
+  }
+];
+var DefaultAssetRegistry = class {
+  nativeTokenAddress = NATIVE_TOKEN_ADDRESS;
+  getToken = getToken;
+  getTokenAddress = getTokenAddress;
+  getChain = getChain;
+};
+var MoneyOS = class {
+  read;
+  executor;
+  assets;
+  runtimeConfig;
+  constructor(config) {
+    const provided = [];
+    if (config.execute) provided.push("execute");
+    if (config.privateKey) provided.push("privateKey");
+    if (config.signer) provided.push("signer");
+    if (provided.length > 1) {
+      throw new Error(
+        `MoneyOSConfig: pass at most one of \`execute\`, \`privateKey\`, or \`signer\`. Received: ${provided.join(", ")}.`
+      );
+    }
+    this.runtimeConfig = {
+      defaultChainId: config.chainId ?? defaultChain.id,
+      rpcUrl: config.rpcUrl
+    };
+    this.read = config.read ?? new ViemReadClient(this.runtimeConfig);
+    this.assets = config.assets ?? new DefaultAssetRegistry();
+    if (config.execute) {
+      this.executor = config.execute;
+    } else if (config.signer) {
+      this.executor = new EOAExecutor(config.signer, this.runtimeConfig);
+    } else if (config.privateKey) {
+      this.executor = EOAExecutor.fromPrivateKey(
+        config.privateKey,
+        this.runtimeConfig
+      );
+    }
+  }
+  get runtime() {
+    return {
+      read: this.read,
+      execute: this.requireExecutor(),
+      assets: this.assets,
+      config: this.runtimeConfig
+    };
+  }
+  get address() {
+    return this.requireExecutor().getAddress();
+  }
+  requireExecutor() {
+    if (!this.executor) {
+      throw new Error(
+        "No signing account configured. Set `signer`, `privateKey`, or `execute` in MoneyOS config."
+      );
+    }
+    return this.executor;
+  }
+  async balance(token, options) {
+    const chainId = options?.chainId ?? this.runtimeConfig.defaultChainId;
+    const account = options?.address ?? this.address;
+    const tokenAddress = this.assets.getTokenAddress(token, chainId);
+    if (!tokenAddress) {
+      throw new Error(`Token ${token} not found on chain ${chainId}`);
+    }
+    const tokenInfo = this.assets.getToken(token);
+    if (tokenAddress === NATIVE_TOKEN_ADDRESS) {
+      const raw2 = await this.read.getBalance({ address: account, chainId });
+      return {
+        token: tokenInfo.name,
+        symbol: tokenInfo.symbol,
+        amount: (0, import_viem4.formatUnits)(raw2, tokenInfo.decimals),
+        rawAmount: raw2,
+        decimals: tokenInfo.decimals,
+        chainId
+      };
+    }
+    const raw = await this.read.readContract({
+      address: tokenAddress,
+      abi: ERC20_ABI2,
+      functionName: "balanceOf",
+      args: [account],
+      chainId
+    });
+    return {
+      token: tokenInfo.name,
+      symbol: tokenInfo.symbol,
+      amount: (0, import_viem4.formatUnits)(raw, tokenInfo.decimals),
+      rawAmount: raw,
+      decimals: tokenInfo.decimals,
+      chainId
+    };
+  }
+  async send(token, to, amount, options) {
+    const execute = this.requireExecutor();
+    const chainId = options?.chainId ?? this.runtimeConfig.defaultChainId;
+    const from = execute.getAddress();
+    const tokenAddress = this.assets.getTokenAddress(token, chainId);
+    if (!tokenAddress) {
+      throw new Error(`Token ${token} not found on chain ${chainId}`);
+    }
+    const tokenInfo = this.assets.getToken(token);
+    const value = (0, import_viem4.parseUnits)(amount, tokenInfo.decimals);
+    if (tokenAddress === NATIVE_TOKEN_ADDRESS) {
+      const result2 = await execute.send({ to, value, chainId });
+      return {
+        hash: result2.hash,
+        from,
+        to,
+        amount,
+        token: tokenInfo.symbol,
+        chainId
+      };
+    }
+    const data = (0, import_viem4.encodeFunctionData)({
+      abi: ERC20_ABI2,
+      functionName: "transfer",
+      args: [to, value]
+    });
+    const result = await execute.send({ to: tokenAddress, data, chainId });
+    return {
+      hash: result.hash,
+      from,
+      to,
+      amount,
+      token: tokenInfo.symbol,
+      chainId
+    };
+  }
+  async swap(tokenIn, tokenOut, amount, provider, options) {
+    const execute = this.requireExecutor();
+    const chainId = options?.chainId ?? this.runtimeConfig.defaultChainId;
+    return executeSwap(
+      { tokenIn, tokenOut, amount, provider, chainId, slippage: options?.slippage },
+      { read: this.read, execute, assets: this.assets }
+    );
+  }
+};
+
+// src/providers/odos.ts
+var ODOS_API = "https://api.odos.xyz";
+var ODOS_NATIVE_ADDRESS = "0x0000000000000000000000000000000000000000";
+var OdosProvider = class {
+  name = "odos";
+  apiKey;
+  constructor(options) {
+    this.apiKey = options?.apiKey;
+  }
+  toOdosAddress(address) {
+    return address === NATIVE_TOKEN_ADDRESS ? ODOS_NATIVE_ADDRESS : address;
+  }
+  async getQuote(params) {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    const response = await fetch(`${ODOS_API}/sor/quote/v2`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        chainId: params.chainId,
+        inputTokens: [
+          {
+            tokenAddress: this.toOdosAddress(params.tokenIn),
+            amount: params.amount.toString()
+          }
+        ],
+        outputTokens: [
+          {
+            tokenAddress: this.toOdosAddress(params.tokenOut),
+            proportion: 1
+          }
+        ],
+        userAddr: params.sender,
+        slippageLimitPercent: params.slippage ?? 1,
+        referralCode: 0,
+        compact: true
+      })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Odos quote failed: ${response.status} ${text}`);
+    }
+    const data = await response.json();
+    return {
+      tokenIn: params.tokenIn,
+      tokenOut: params.tokenOut,
+      amountIn: params.amount.toString(),
+      expectedOut: data.outAmounts[0],
+      router: "",
+      chainId: params.chainId,
+      pathId: data.pathId,
+      sender: params.sender
+    };
+  }
+  async getCalldata(quote) {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    }
+    const response = await fetch(`${ODOS_API}/sor/assemble`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        userAddr: quote.sender,
+        pathId: quote.pathId,
+        simulate: false
+      })
+    });
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Odos assemble failed: ${response.status} ${text}`);
+    }
+    const data = await response.json();
+    return {
+      to: data.transaction.to,
+      data: data.transaction.data,
+      value: BigInt(data.transaction.value)
+    };
+  }
+};
+
+// src/core/access-local.ts
+var import_accounts2 = require("viem/accounts");
+var LocalAccessSession = class {
+  kind = "local";
+  address;
+  constructor(privateKey) {
+    this.address = (0, import_accounts2.privateKeyToAccount)(privateKey).address;
+  }
+  getAddress() {
+    return this.address;
+  }
+};
+var LocalAccessAdapter = class {
+  name = "local";
+  privateKey;
+  constructor(privateKey) {
+    this.privateKey = privateKey;
+  }
+  async openSession(_ctx) {
+    return new LocalAccessSession(this.privateKey);
+  }
+};
+
+// src/core/keystore-file.ts
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+var import_accounts3 = require("viem/accounts");
+var DEFAULT_CONFIG_PATH = (0, import_node_path.join)((0, import_node_os.homedir)(), ".moneyos", "config.json");
+var FileKeyStore = class {
+  kind = "file";
+  configPath;
+  constructor(options = {}) {
+    this.configPath = options.configPath ?? DEFAULT_CONFIG_PATH;
+  }
+  async hasKey() {
+    const config = this.readConfig();
+    return Boolean(config?.privateKey);
+  }
+  async metadata() {
+    const config = this.readConfig();
+    const address = config?.privateKey ? (0, import_accounts3.privateKeyToAccount)(config.privateKey).address : void 0;
+    return {
+      kind: "file",
+      address
+    };
+  }
+  async loadSigner() {
+    const config = this.readConfig();
+    if (!config?.privateKey) {
+      throw new Error(
+        `FileKeyStore: no private key found at ${this.configPath}. Run \`moneyos init\` to create one.`
+      );
+    }
+    return privateKeyToManagedAccount(config.privateKey);
+  }
+  /**
+   * Read and validate the config file. Returns `undefined` if the file does
+   * not exist. Throws with context for any other failure mode (malformed
+   * JSON, wrong top-level type, wrong `privateKey` type). The hex format of
+   * the key itself is validated later by viem's `privateKeyToAccount`.
+   */
+  readConfig() {
+    if (!(0, import_node_fs.existsSync)(this.configPath)) {
+      return void 0;
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse((0, import_node_fs.readFileSync)(this.configPath, "utf-8"));
+    } catch (error) {
+      throw new Error(
+        `FileKeyStore: failed to read config at ${this.configPath}`,
+        { cause: error }
+      );
+    }
+    if (typeof parsed !== "object" || parsed === null) {
+      throw new Error(
+        `FileKeyStore: config at ${this.configPath} is not a JSON object`
+      );
+    }
+    const pk = parsed.privateKey;
+    if (pk === void 0 || pk === null) {
+      return {};
+    }
+    if (typeof pk !== "string") {
+      throw new Error(
+        `FileKeyStore: privateKey at ${this.configPath} must be a string`
+      );
+    }
+    return { privateKey: pk };
+  }
+};
+
+// src/core/factory.ts
+function createMoneyOS(config) {
+  return new MoneyOS(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EOAExecutor,
+  FileKeyStore,
+  LocalAccessAdapter,
+  MoneyOS,
+  NATIVE_TOKEN_ADDRESS,
+  OdosProvider,
+  ViemReadClient,
+  chains,
+  createMoneyOS,
+  defaultChain,
+  getChain,
+  getToken,
+  getTokenAddress,
+  tokens
+});
+//# sourceMappingURL=index.cjs.map