emblemcompany/emblem-ai-agent-wallet

Was macht emblem-ai-agent-wallet?

Stellen Sie eine Verbindung zu EmblemVault her und verwalten Sie Krypto-Wallets über EmblemAI. Unterstützt Solana, Ethereum, Base, BSC, Polygon, Hedera und Bitcoin. Verwenden Sie dies, wenn der Benutzer Krypto handeln, Guthaben prüfen, Token tauschen, mit Blockchain-Wallets interagieren oder profilbezogene Agenten-Wallets erstellen und nutzen möchte.

Funktionen

• Wallet-Verwaltung: Erstellen, importieren und verwalten Sie Wallets über mehrere Blockchains hinweg.
• Guthabenabfragen: Prüfen Sie Kontostände für native Token und ERC-20-ähnliche Token.
• Token-Swaps: Tauschen Sie Token innerhalb unterstützter Chains.
• Transaktionen: Senden und empfangen Sie Kryptowährungen.
• Profilbezogene Wallets: Erstellen Sie Wallets, die an ein Benutzerprofil gebunden sind, für wiederholte Nutzung.

Unterstützte Blockchains

Blockchain	Typ	Unterstützt seit Version
Solana	L1	1.0.0
Ethereum	L1/L2	1.0.0
Base	L2	1.0.0
BSC	L1	1.0.0
Polygon	L2	1.0.0
Hedera	L1	1.1.0
Bitcoin	L1	1.2.0

Voraussetzungen

• Ein EmblemAI-Konto mit aktiviertem Wallet-Modul.
• API-Schlüssel für EmblemVault (Umgebungsvariablen: EMBLEM_API_KEY, EMBLEM_SECRET).
• Node.js v18 oder höher für lokale Entwicklung.

Schnellstart

1. Installieren Sie das Paket:

   npm install @emblemai/agent-wallet
   

2. Konfigurieren Sie Umgebungsvariablen:

   export EMBLEM_API_KEY="Ihr-API-Schlüssel"
   export EMBLEM_SECRET="Ihr-Geheimnis"
   

3. Importieren und verwenden Sie die Fähigkeit in Ihrem Agenten-Code:

   import { EmblemWallet } from '@emblemai/agent-wallet';
   
   const wallet = new EmblemWallet({
     apiKey: process.env.EMBLEM_API_KEY,
     secret: process.env.EMBLEM_SECRET
   });
   
   // Guthaben abfragen
   const balance = await wallet.getBalance('solana', 'Adresse123...');
   console.log(balance);
   

Beispiele

Guthaben auf Ethereum prüfen

const ethBalance = await wallet.getBalance('ethereum', '0xBenutzerAdresse...');

Token auf Solana tauschen

const swapResult = await wallet.swapTokens('solana', {
   fromToken: 'So11111111111111111111111111111111111111112',
   toToken: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
   amount: 1.0 // SOL
});

API-Referenz

• getBalance(chain: string, address: string): Promise<BigNumber>
• sendTransaction(chain: string, to: string, amount: string): Promise<string>
• swapTokens(chain: string, params: SwapParams): Promise<SwapResult>
• createWallet(chain: string, profileId?: string): Promise<Wallet>
• listWallets(profileId: string): Promise<Wallet[]>

Fehlerbehandlung

Die Fähigkeit verwendet standardmäßige HTTP-Statuscodes und Fehlerobjekte. Häufige Fehler:

• 400 Ungültige Anfrage: Falsche Parameter.
• 401 Nicht autorisiert: Fehlende oder ungültige API-Schlüssel.
• 429 Zu viele Anfragen: Ratenbegrenzung erreicht.
• 500 Interner Serverfehler: Problem auf der EmblemAI-Seite.

Sicherheit

• Bewahren Sie API-Schlüssel sicher in Umgebungsvariablen auf.
• Teilen Sie private Schlüssel oder Seed-Phrasen nicht im Klartext.
• Verwenden Sie profilbezogene Wallets, um die Wallet-Erstellung pro Benutzer zu isolieren.

Lizenz

MIT