sauce-sdk

Tooling for the Sauce protocol, published as a single npm package: @eco-incorp/sauce-sdk.

Includes:

• A JS-like recipe compiler that emits Sauce bytecode.
• A TypeScript SDK for building recipes against on-chain protocols (Uniswap, Curve, Balancer, …).
• High-level action primitives (AMM swaps, multi-hop, split routing).
• A local dev environment (hardhat fork, recipe runner, examples).

Install

pnpm add @eco-incorp/sauce-sdk
# or
npm install @eco-incorp/sauce-sdk

Import paths

Everything ships under the single @eco-incorp/sauce-sdk package with subpath exports:

import { compile } from '@eco-incorp/sauce-sdk/compiler'
import { protocolInfo } from '@eco-incorp/sauce-sdk/protocols/uniswap-v3'
import { megaSwap } from '@eco-incorp/sauce-sdk/recipes'
import { Saucer } from '@eco-incorp/sauce-sdk/actions'
// the bare specifier is the SDK entry
import { /* ... */ } from '@eco-incorp/sauce-sdk'

Repo layout

Sources are organised as a pnpm workspace for development; everything ships under the single @eco-incorp/sauce-sdk name at publish time.

| Path | What's in it | Subpath | | --- | --- | --- | | compiler/ | Recipe compiler (JS → Sauce bytecode) | /compiler | | sdk/ | Protocols, chains, skills, recipes | /, /protocols/*, /chains, /skills, /recipes | | actions/ | High-level action primitives | /actions | | dev-tools/ | Local fork environment, recipe runner, examples | bin: sauce-dev-tools |

Development

pnpm install
pnpm build       # build compiler first, then sdk + actions
pnpm typecheck   # typecheck all areas
pnpm test        # run all tests

Publishing

Tag-driven via .github/workflows/publish.yml:

git tag v1.2.3 && git push origin v1.2.3

The workflow stamps the root package with the tag's version and publishes @eco-incorp/sauce-sdk to both npmjs.com and GitHub Packages.