Skip to main content

Invest into a vault

This guide shows how to invest into a Centrifuge vault using the Centrifuge SDK.
It covers setup, connecting to mainnet or testnet, and sending your first investment transaction.

Prerequisites​

Before you begin, make sure you have:

  • Node.js (v18 or later recommended)
  • A package manager: npm or yarn
  • A wallet or signer that can connect to Ethereum-compatible chains (e.g. MetaMask, WalletConnect, or a private key account via Viem)
  • Investment currency (e.g. USDC) on mainnet or testnet

Installation​

Install the Centrifuge SDK in your project:

pnpm add @centrifuge/sdk

1. Initialize the SDK​

Create a Centrifuge instance and connect it to mainnet:

import Centrifuge from "@centrifuge/sdk";

const centrifuge = new Centrifuge({
  environment: "mainnet",
});
info

For testing purposes, you can connect to testnet instead by setting environment: testnet.

2. Set a signer​

To send transactions, attach a signer (for example, from MetaMask or another EIP-1193 compatible provider):

// Example: using a MetaMask injected provider
const provider = (window as any).ethereum;
await provider.request({ method: "eth_requestAccounts" });

centrifuge.setSigner(provider);

If you’re using a private key or server-side setup, you can also provide a Viem LocalAccount.

3. Get a pool and vault​

Each pool can contain multiple share classes and each share class can have multiple vaults issuing tokens against an deposit asset. You need the pool ID, share class ID, chain ID, and asset address.

// Get a pool by ID
const poolId = new PoolId(1);
const pool = await centrifuge.pool(poolId);
const scId = ShareClassId.from(poolId, 1);
const assetId = AssetId.from(centId, 1);
const chainId = 11155111; // Ethereum Sepolia
// Get a vault
const vault = await pool.vault(chainId, scId, assetId);

4. Place an investment order​

You can now create an investment order by specifying the amount of currency to invest:

const { investmentCurrency } = await vault.details();
const amount = Balance.fromFloat(1000, investmentCurrency.decimals);
const tx = await vault.increaseInvestOrder(amount);

Depending on the vault type:

  • Sync vaults: the investment settles immediately.
  • Async vaults: the order is processed during the next epoch.

5. Claim your shares​

Once the investment is processed (immediately or after an epoch), you need to claim your shares:

const claimTx = await vault.claim();
console.log("Claim transaction hash:", claimTx.hash);

6. Check investor position​

You can query your current position in the vault at any time:

const investor = await vault.investment("0xYourWalletAddress");

console.log(investor.shareBalance); // current balance of shares
console.log(investor.pendingInvestCurrency); // still pending investment
console.log(investor.claimableInvestShares); // shares ready to be claimed