B3 SDK

O que é o B3 SDK?

O B3 SDK (@b3dotfun/sdk) é um SDK unificado TypeScript que fornece tudo o que você precisa para construir aplicações no ecossistema B3. Ele combina uma poderosa infraestrutura de pagamento cross-chain com autenticação sem emendas, tudo envolvido em componentes React amigáveis para desenvolvedores e serviços headless.

Arquitetura

O SDK é organizado em módulos focados projetados para máxima flexibilidade e facilidade de uso:

Estrutura do Módulo

Cada módulo contém componentes organizados e construídos com um propósito específico:
  • react/ - Componentes React e hooks para fácil integração
  • services/ - Serviços TypeScript headless para implementações personalizadas
  • types/ - Definições TypeScript abrangentes
  • utils/ - Funções utilitárias e ajudantes
  • constants/ - Configuração e constantes

Suporte à Plataforma

FuncionalidadeReact WebReact NativeHeadless
AnySpend
Contas Globais
Utils Compartilhados

Instalação

npm install @b3dotfun/sdk

Estilos CSS

Importe os estilos padrão para a melhor experiência visual:
import "@b3dotfun/sdk/index.css";

Início Rápido

Pagamentos Cross-Chain com AnySpend

import { AnySpend } from "@b3dotfun/sdk/anyspend/react";

function PaymentPage() {
  return <AnySpend mode="page" />;
}

Autenticação com Contas Globais

import { B3Provider, SignInWithB3 } from "@b3dotfun/sdk/global-account/react";

function App() {
  return (
    <B3Provider environment="production">
      <SignInWithB3
        provider={{ strategy: "google" }}
        partnerId="your-partner-id"
        onLoginSuccess={(globalAccount) => {
          console.log("Autenticado:", globalAccount);
        }}
      />
    </B3Provider>
  );
}

Cunhagem de NFT

import { AnySpendNFTButton } from "@b3dotfun/sdk/anyspend/react";

function NFTMinting() {
  const nftContract = {
    address: "0x9c275ff1634519E9B5449ec79cd939B5F900564d",
    chainId: 8333,
    name: "Exemplo de Coleção NFT",
    imageUrl: "https://example.com/nft.jpg",
    price: "1000000000000000000", // 1 ETH em wei
    currency: { symbol: "ETH", decimals: 18 }
  };

  return (
    <AnySpendNFTButton
      nftContract={nftContract}
      recipientAddress="0x..."
    />
  );
}

Principais Funcionalidades

Infraestrutura de Pagamento Universal

Pagamentos com Qualquer Token

Aceite pagamentos em qualquer criptomoeda com conversão automática para o seu token preferido.

Trocas Cross-Chain

Habilite trocas de tokens sem emendas em mais de 20 blockchains suportadas com roteamento otimizado.

Cunhagem de NFT

Botões de cunhagem de NFT com um clique que aceitam pagamentos em qualquer token de qualquer cadeia.

Rampas de Acesso Fiat

Rampas de acesso fiat-para-cripto integradas para usuários sem criptomoeda existente.

Autenticação Sem Emendas

Login Social

Google, Discord e outros provedores sociais com integração instantânea.

Chaves de Sessão

Gerenciamento de sessão seguro com permissões granulares para uma UX aprimorada.

Identidade Cross-Platform

Identidade única que funciona em todas as aplicações e jogos B3.

Contas Inteligentes

Abstração de conta inteligente integrada para transações sem custo de gás.

Serviços TypeScript Headless

Para desenvolvedores que precisam de controle máximo, toda a funcionalidade está disponível através de serviços headless:

Serviços AnySpend

import { anyspendService } from "@b3dotfun/sdk/anyspend/services/anyspend";

// Obter cotação para troca cross-chain
const quote = await anyspendService.getQuote({
  srcChain: 1,
  dstChain: 8333,
  srcTokenAddress: "0x...",
  dstTokenAddress: "0x...",
  srcAmount: "1000000",
  recipientAddress: "0x...",
  type: "swap"
});

// Criar e executar pedido
const order = await anyspendService.createOrder({
  // ... parâmetros do pedido
});

Serviços de Conta Global

import { authenticate } from "@b3dotfun/sdk/global-account/app";

// Autenticar usuário
const authResult = await authenticate(
  "access-token",
  "identity-token"
);

if (authResult) {
  console.log("Autenticação bem-sucedida:", authResult);
}

Suporte & Comunidade

Próximos Passos?

  1. Instale o SDK e importe os estilos
  2. Configure o AnySpend para pagamentos cross-chain
  3. Configure Contas Globais para autenticação de usuários
  4. Explore exemplos e padrões de implementação
  5. Junte-se à comunidade para suporte e atualizações
O B3 SDK fornece tudo o que você precisa para construir a próxima geração de aplicações cross-chain com experiências de usuário sem emendas. Comece a construir hoje!