@mento-protocol/mento-sdk

Mento SDK

The official Mento Protocol SDK for interacting with Multi-Collateral Mento smart contracts on the Celo network.

Installation

# Install with npm
npm install @mento-protocol/mento-sdk

# Or install with yarn
yarn add @mento-protocol/mento-sdk

Learn more

You can find example usages of the SDK in the mento-sdk-examples repository. For in-depth documentation and walk through explanations please see the SDK section of the Mento docs.

Tradable Pairs Cache

Anytime we launch a new stable token, we need to update the tradable pairs cache.

The yarn cacheTradablePairs script generates a TypeScript file containing a list of all tradable pairs on the Mento protocol. This file is used to cache the tradable pairs in the SDK and avoid costly re-fetching from the network.

yarn cacheTradablePairs

Token Graph Visualization

Current token connectivity on Celo Mainnet (last updated: 2025-06-19):

graph TD
    USDT["USD₮"]
    USDC --- cUSD
    USDT --- cUSD
    CELO --- cEUR
    CELO --- cREAL
    USDC --- cREAL
    USDC --- cEUR
    axlUSDC --- cUSD
    CELO --- cUSD
    PUSO --- cUSD
    cJPY --- cUSD
    cCOP --- cUSD
    cGBP --- cUSD
    cUSD --- cZAR
    cCAD --- cUSD
    cAUD --- cUSD
    cCHF --- cUSD
    axlUSDC --- cEUR
    axlUSDC --- cREAL
    axlEUROC --- cEUR
    cKES --- cUSD
    cGHS --- cUSD
    cNGN --- cUSD
    CELO --- eXOF
    axlEUROC --- eXOF

Network Stats: 20 tokens, 24 direct trading pairs

💡 This graph shows direct trading pairs only. The SDK automatically finds optimal routes including multi-hop paths.

To regenerate: yarn getTokenGraph