@caatinga/client

Browser and Node integration layer for generated Soroban bindings, caatinga.artifacts.json, network config, and wallet adapters.

Install

npm install @caatinga/client @caatinga/core

Optional wallet adapters:

npm install @stellar/freighter-api                    # Freighter
npm install @creit.tech/stellar-wallets-kit         # Stellar Wallets Kit

Example

import { createCaatingaClient } from "@caatinga/client";
import { createStellarWalletsKitAdapter } from "@caatinga/client/stellar-wallets-kit";
import * as Counter from "./contracts/generated/counter";
import artifacts from "../caatinga.artifacts.json";

const client = createCaatingaClient({
  network: {
    name: "testnet",
    rpcUrl: "https://soroban-testnet.stellar.org",
    networkPassphrase: "Test SDF Network ; September 2015",
  },
  artifacts,
  wallet: createStellarWalletsKitAdapter(),
  contracts: { counter: { binding: Counter } },
});

const value = await client.contract("counter").read<number>("get");
const result = await client.contract("counter").invoke<number>("increment");

React apps: WalletProvider and useWallet from @caatinga/client/react.

Documentation

• Client API
• Wallets and adapters
• Errors

Single-invoker browser flows only until v1.0 — see Client scope.