Developer Quick Start

npm install @cultura/sdk
# or
yarn add @cultura/sdk
# or
pnpm add @cultura/sdk

import { CulturaSDK } from '@cultura/sdk';

// Create SDK instance with default configuration (testnet) read-only
const readOnlySdk = CulturaSDK.create();

// Create SDK instance for a specific environment (read-only)
const devnetSdk = CulturaSDK.create({ chain: 'devnet' });
const localSdk = CulturaSDK.create({ chain: 'local' });

import { CulturaSDK } from '@cultura/sdk';

// Create SDK instance with wallet connection (uses testnet by default)
// Assumes 'window.ethereum' is available
const walletSdk = CulturaSDK.createWithWallet(window.ethereum);

// Create SDK instance with wallet connection and specific chain
const localWalletSdk = CulturaSDK.createWithWallet(window.ethereum, {
  chain: 'local',
});

import { CulturaSDK } from '@cultura/sdk';
import { privateKeyToAccount } from 'viem/accounts';

// Create SDK instance with a specific account address (limited signing capability)
const addressSdk = CulturaSDK.createWithAccount('0x123...' as `0x${string}`, {
  chain: 'testnet',
}); // Replace with actual address

// Create SDK instance with an account from a private key (full signing capability)
// WARNING: Handle private keys securely, especially in backend environments.
const account = privateKeyToAccount('0xYourPrivateKeyHere'); // Replace with actual private key
const privateKeySdk = CulturaSDK.createWithAccount(account, {
  chain: 'testnet',
});

const config = {
  // Chain identifier: 'local', 'devnet', 'testnet', or a chain ID number
  chain: 'testnet',

  // Optional: Provide a custom Viem Transport (e.g., for custom RPC)
  // transport: http('https://your-custom-rpc.com'),

  // Optional: Provide a pre-configured Viem WalletClient
  // wallet: existingWalletClient,

  // Optional: Specify the account (address or Viem Account object)
  // account: '0x...' or accountObject,

  // Optional: Override default contract addresses for the selected chain
  contracts: {
    attestationService: '0x...',
    culturaDigitalAsset: '0x...',
    // ... other contract addresses if needed
  }
};

const sdk = CulturaSDK.create(config);
// or CulturaSDK.createWithWallet(provider, config);
// or CulturaSDK.createWithAccount(account, config);

async function checkBalance(sdk: CulturaSDK) {
  if (!sdk.walletClient?.account) {
    console.log("Wallet not connected. Cannot fetch balance.");
    // Try a read-only operation instead
    try {
      const totalSupply = await sdk.culturaDigitalAsset.totalSupply();
      console.log(`Read-only check: Total CulturaDigitalAsset supply: ${totalSupply}`);
    } catch (readError) {
      console.error("Failed to perform read-only check:", readError);
    }
    return;
  }

  try {
    const balance = await sdk.getWalletBalance();
    console.log(`Wallet balance: ${balance} wei`);
  } catch (error) {
    console.error("Error fetching wallet balance:", error);
  }
}

// Example with a wallet-connected SDK
// const myWalletSdk = CulturaSDK.createWithWallet(window.ethereum);
// checkBalance(myWalletSdk);

// Example with a read-only SDK (will log the read-only check)
// const myReadOnlySdk = CulturaSDK.create({ chain: 'testnet' });
// checkBalance(myReadOnlySdk);

import React, { createContext, useContext, useEffect, useState } from "react";
import { CulturaSDK, getChainName } from "@cultura/sdk";
// Assume you have a hook or library to manage wallet connection (e.g., RainbowKit, Wagmi, Web3Modal)
import { useWallet } from "your-wallet-provider"; // Replace with your actual wallet hook

const SDKContext = createContext<CulturaSDK | null>(null);

export function useSDK() {
  const context = useContext(SDKContext);
  // Return null if used outside the provider, allows for conditional logic
  return context;
}

export function SDKProvider({ children }: { children: React.ReactNode }) {
  // Adapt these based on your wallet provider's state
  const { isConnected, provider, chainId, account } = useWallet();
  const [sdk, setSdk] = useState<CulturaSDK | null>(null);

  useEffect(() => {
    // Only initialize SDK if wallet is connected and provider exists
    if (!isConnected || !provider || !chainId || !account) {
      // Optionally create a read-only SDK as a fallback
      setSdk(CulturaSDK.create({ chain: 'testnet' })); // Fallback to testnet read-only
      console.log("Cultura SDK initialized in read-only mode (wallet not connected).");
      return;
    }

    try {
      // Create SDK with wallet connection
      // Note: 'provider' might need adjustment based on your library (e.g., Ethers provider, Viem transport)
      // The SDK expects an EIP-1193 compliant provider (like window.ethereum or WalletConnect provider)
      const newSdk = CulturaSDK.createWithWallet(provider, {
        chain: getChainName(chainId), // Ensure getChainName handles your supported chain IDs
        account: account as `0x${string}`,
      });
      setSdk(newSdk);
      console.log("Cultura SDK initialized with wallet connection.");
    } catch (error) {
      console.error("Failed to initialize Cultura SDK with wallet:", error);
      // Handle cases where the chainId might not be supported by the SDK
      // Fallback to a read-only instance
      setSdk(CulturaSDK.create({ chain: 'testnet' }));
      console.log("Cultura SDK initialized in read-only mode (wallet connection failed or unsupported chain).");
    }
  }, [isConnected, provider, chainId, account]); // Re-run effect if connection state changes

  return <SDKContext.Provider value={sdk}>{children}</SDKContext.Provider>;
}