@eco-incorp/sauce 0.99.6 → 0.99.8

package/sdk/dist/sauce-script/ts-plugin.cjs

@@ -0,0 +1,85 @@
+// A TypeScript language service plugin for SauceScript program files (`*.sauce.ts`): it removes
+// the errors TypeScript reports on what is valid SauceScript and no declaration can describe.
+//
+//   - An integer index, `xs[i]` with `i` a `bigint` (TS2538). Every SauceScript number is a 256-bit
+//     integer, so every index is a bigint, and TypeScript refuses a bigint index outright.
+//   - A number and a bigint together: `x == 0`, `n + 1`, `f(500)` where a bigint is declared
+//     (TS2365, TS2367, TS2322, TS2345). In SauceScript `1` and `1n` are the same integer.
+//   - An undeclared UPPER_CASE name (TS2304, TS2552): a define, which the compile is given
+//     (`--define AMOUNT=5`) and the editor is not. A misspelled one still fails the compile.
+//
+// Everything else TypeScript reports stays: a misspelled builtin, a wrong argument count, a method a
+// contract does not have. Only `*.sauce.ts` files are filtered; any other file in the project is
+// left as TypeScript reports it. `sauce init` names this plugin in the program directory's
+// tsconfig.json; tsserver loads it from the project's own `node_modules`, so an editor has to run
+// the workspace's TypeScript for it to load (the declarations need nothing of the kind).
+"use strict";
+
+const DEFINE = /^[A-Z][A-Z0-9_]*$/;
+/** A TypeScript type that is a SauceScript integer: `bigint`, `number`, or a literal of either. */
+const INT = String.raw`(?:bigint|number|-?\d+n?|SauceInt)`;
+const BIGINT = String.raw`(?:bigint|-?\d+n)`;
+const NUMBER = String.raw`(?:number|-?\d+)`;
+
+const PATTERNS = {
+  // Type 'bigint' cannot be used as an index type. / Type '0n' cannot be …
+  2538: new RegExp(String.raw`^Type '${BIGINT}' cannot be used as an index type`),
+  // Operator '+' cannot be applied to types 'number' and 'bigint'.
+  2365: new RegExp(String.raw`^Operator '[^']+' cannot be applied to types '${INT}' and '${INT}'`),
+  // This comparison appears to be unintentional because the types 'bigint' and 'number' have no overlap.
+  2367: new RegExp(String.raw`because the types '${INT}' and '${INT}' have no overlap`),
+  // Type 'number' is not assignable to type 'bigint'.
+  2322: new RegExp(String.raw`^Type '${NUMBER}' is not assignable to type '${BIGINT}'`),
+  // Argument of type '500' is not assignable to parameter of type 'bigint'.
+  2345: new RegExp(
+    String.raw`^Argument of type '${NUMBER}' is not assignable to parameter of type '${BIGINT}'`,
+  ),
+};
+
+/**
+ * Whether `diagnostic` is one TypeScript reports on valid SauceScript. `flatten` is TypeScript's
+ * `flattenDiagnosticMessageText`.
+ */
+function isFalsePositive(diagnostic, flatten) {
+  const text = flatten(diagnostic.messageText, "\n");
+  if (diagnostic.code === 2304 || diagnostic.code === 2552) {
+    const name = /^Cannot find name '([^']+)'/.exec(text);
+
+    return name !== null && DEFINE.test(name[1]);
+  }
+  const pattern = PATTERNS[diagnostic.code];
+
+  return pattern !== undefined && pattern.test(text);
+}
+
+const isProgram = (fileName) => /\.sauce\.ts$/.test(fileName);
+
+function init(modules) {
+  const ts = modules.typescript;
+
+  return {
+    create(info) {
+      const service = info.languageService;
+      const proxy = Object.create(null);
+      for (const key of Object.keys(service)) {
+        const member = service[key];
+        proxy[key] = typeof member === "function" ? member.bind(service) : member;
+      }
+      proxy.getSemanticDiagnostics = (fileName) => {
+        const diagnostics = service.getSemanticDiagnostics(fileName);
+
+        return isProgram(fileName)
+          ? diagnostics.filter(
+              (diagnostic) => !isFalsePositive(diagnostic, ts.flattenDiagnosticMessageText),
+            )
+          : diagnostics;
+      };
+
+      return proxy;
+    },
+  };
+}
+
+init.isFalsePositive = isFalsePositive;
+init.isProgram = isProgram;
+module.exports = init;

package/sdk/dist/skills/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAIzC"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAKzC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAIzC"}

package/sdk/dist/skills/loader.js

@@ -1,6 +1,7 @@
-// The skill documents are embedded at build time (`embedded/skills.generated.ts`), so this module
-// reads no filesystem and works in a browser. The `.md` files under `src/skills/` remain the source
-// of truth, and still ship in the package for readers who want the files themselves.
+// The per-protocol documents are embedded at build time (`embedded/skills.generated.ts`), so this
+// module reads no filesystem and works in a browser. Their source of truth is the `sauce-protocols`
+// agent skill, `skills/sauce-protocols/references/*.md` at the package root: the files ship there,
+// `sauce skills install` copies them into a project, and this module returns the same text.
 import { SKILL_DOCUMENTS } from "../embedded/skills.generated.js";
 const INDEX = "index";
 /**

package/sdk/dist/skills/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,oGAAoG;AACpG,qFAAqF;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,KAAK,GAAG,OAAO,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAErF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAE9D,OAAO,eAAe,CAAC,IAAI,CAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;SAChC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC;SAChC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,KAAK,CACd,qCAAqC,IAAI,4CAA4C,CACtF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,oGAAoG;AACpG,mGAAmG;AACnG,4FAA4F;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,KAAK,GAAG,OAAO,CAAC;AAEtB;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAErF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAE9D,OAAO,eAAe,CAAC,IAAI,CAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;SAChC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC;SAChC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,KAAK,CACd,qCAAqC,IAAI,4CAA4C,CACtF,CAAC;AACJ,CAAC"}

package/sdk/dist/std/router/balancer-v2-vault.abi.json

@@ -0,0 +1,78 @@
+{
+  "$comment": "The Balancer V2 Vault's swap(singleSwap, funds, limit, deadline): the registry's BalancerV2VaultABI fragment (protocols/balancer-v2), which test/registry-abi.test.ts pins to the deployed Vault, 0xBA12222222228d8Ba445958a75a0704d566BF2C8. Its uint256 output is the amount the swap paid out.",
+  "abi": [
+    {
+      "name": "swap",
+      "type": "function",
+      "stateMutability": "payable",
+      "inputs": [
+        {
+          "name": "singleSwap",
+          "type": "tuple",
+          "components": [
+            {
+              "name": "poolId",
+              "type": "bytes32"
+            },
+            {
+              "name": "kind",
+              "type": "uint8"
+            },
+            {
+              "name": "assetIn",
+              "type": "address"
+            },
+            {
+              "name": "assetOut",
+              "type": "address"
+            },
+            {
+              "name": "amount",
+              "type": "uint256"
+            },
+            {
+              "name": "userData",
+              "type": "bytes"
+            }
+          ]
+        },
+        {
+          "name": "funds",
+          "type": "tuple",
+          "components": [
+            {
+              "name": "sender",
+              "type": "address"
+            },
+            {
+              "name": "fromInternalBalance",
+              "type": "bool"
+            },
+            {
+              "name": "recipient",
+              "type": "address"
+            },
+            {
+              "name": "toInternalBalance",
+              "type": "bool"
+            }
+          ]
+        },
+        {
+          "name": "limit",
+          "type": "uint256"
+        },
+        {
+          "name": "deadline",
+          "type": "uint256"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "amountCalculated",
+          "type": "uint256"
+        }
+      ]
+    }
+  ]
+}

package/sdk/dist/std/router/curve-cryptoswap.abi.json

@@ -0,0 +1,29 @@
+{
+  "$comment": "Curve's uint256-index exchange(i, j, dx, min_dy), copied from the verified tricrypto-ng pool on Ethereum, CurveTricryptoOptimizedWETH 0x7F86Bf177Dd4F3494b841a37e810A34dD56c829B (vyper 0.3.9). Its uint256 output is deliberately not declared, like the registry's int128 CurveThreePoolABI: older crypto pools (tricrypto2) return nothing, and a declared output is decoded.",
+  "abi": [
+    {
+      "name": "exchange",
+      "type": "function",
+      "stateMutability": "payable",
+      "inputs": [
+        {
+          "name": "i",
+          "type": "uint256"
+        },
+        {
+          "name": "j",
+          "type": "uint256"
+        },
+        {
+          "name": "dx",
+          "type": "uint256"
+        },
+        {
+          "name": "min_dy",
+          "type": "uint256"
+        }
+      ],
+      "outputs": []
+    }
+  ]
+}

package/sdk/dist/std/router/curve-stableswap.abi.json

@@ -0,0 +1,29 @@
+{
+  "$comment": "Curve's int128-index exchange(i, j, dx, min_dy): the registry's CurveThreePoolABI fragment (protocols/curve), which test/registry-abi.test.ts pins to 3pool on Ethereum, 0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7. StableSwap and StableSwap-NG pools share the selector. No output is declared: a 3pool-era pool returns nothing, and a declared output is decoded.",
+  "abi": [
+    {
+      "name": "exchange",
+      "type": "function",
+      "stateMutability": "nonpayable",
+      "inputs": [
+        {
+          "name": "i",
+          "type": "int128"
+        },
+        {
+          "name": "j",
+          "type": "int128"
+        },
+        {
+          "name": "dx",
+          "type": "uint256"
+        },
+        {
+          "name": "min_dy",
+          "type": "uint256"
+        }
+      ],
+      "outputs": []
+    }
+  ]
+}

package/sdk/dist/std/router/dodo-v2-pool.abi.json

@@ -0,0 +1,39 @@
+{
+  "$comment": "DODO V2 sellBase(to) and sellQuote(to), copied from the verified DVM implementation on Ethereum, 0x7cA7B5EAAf526d93705d28c1b47E9739595C90E7 (solc 0.6.9), which the WETH/USDC DVM 0x8B2F062d112aE1ac6Ccc6C358cc40C9518c847Dc clones. DPP and DSP pools declare the same two functions.",
+  "abi": [
+    {
+      "name": "sellBase",
+      "type": "function",
+      "stateMutability": "nonpayable",
+      "inputs": [
+        {
+          "name": "to",
+          "type": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "receiveQuoteAmount",
+          "type": "uint256"
+        }
+      ]
+    },
+    {
+      "name": "sellQuote",
+      "type": "function",
+      "stateMutability": "nonpayable",
+      "inputs": [
+        {
+          "name": "to",
+          "type": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "receiveBaseAmount",
+          "type": "uint256"
+        }
+      ]
+    }
+  ]
+}

package/sdk/dist/std/router/lb-pair.abi.json

@@ -0,0 +1,55 @@
+{
+  "$comment": "Trader Joe Liquidity Book swap(swapForY, to) and getSwapOut(amountIn, swapForY), copied from the verified LBPair implementation on Avalanche, 0x7a5b4e301fc2B148ceFe57257A236EB845082797 (solc 0.8.20), which every LB v2.2 pair clones. swap returns both lanes in one word: X in the low 128 bits, Y in the high 128.",
+  "abi": [
+    {
+      "name": "swap",
+      "type": "function",
+      "stateMutability": "nonpayable",
+      "inputs": [
+        {
+          "name": "swapForY",
+          "type": "bool"
+        },
+        {
+          "name": "to",
+          "type": "address"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "amountsOut",
+          "type": "bytes32"
+        }
+      ]
+    },
+    {
+      "name": "getSwapOut",
+      "type": "function",
+      "stateMutability": "view",
+      "inputs": [
+        {
+          "name": "amountIn",
+          "type": "uint128"
+        },
+        {
+          "name": "swapForY",
+          "type": "bool"
+        }
+      ],
+      "outputs": [
+        {
+          "name": "amountInLeft",
+          "type": "uint128"
+        },
+        {
+          "name": "amountOut",
+          "type": "uint128"
+        },
+        {
+          "name": "fee",
+          "type": "uint128"
+        }
+      ]
+    }
+  ]
+}

package/sdk/dist/std/router/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@sauce/router",
+  "version": "0.0.0",
+  "private": true,
+  "description": "SauceScript swap library: one function per venue, taking run-time arguments and returning the amount received. `main` names the NEUTRAL BASE the compiler suffixes per target (router.evm.js); there is no router.js and no SVM arm, because every venue here is an EVM contract and the Pot's Router is an EVM contract, so importing the package for any other target fails at the import instead of compiling something wrong.",
+  "main": "router.js"
+}