Ferramentas de desenvolvedor EmblemAI
Ferramentas de desenvolvedor EmblemAI para gerenciamento de usuários em um clique, usuários habilitados para carteira, fluxos de trabalho de cripto com IA e introspecção de aplicativos.
Em uma frase: Emblem é a maneira mais fácil de adicionar gerenciamento de usuários, autenticação de site e contas de usuário habilitadas para carteira a um aplicativo, com opções de login que incluem carteiras, e-mail/senha e login social, além de chat integrado e ferramentas de introspecção.
Nomes de pacotes legados como @emblemvault/hustle-react e hustle-incognito são mantidos onde ainda fazem parte da superfície de integração atual.
Modelo de Segurança e Confiança
Este skill descreve autenticação de carteira de criptomoedas e capacidades de assistente alimentado por IA. Ele envolve inerentemente:
- Operações financeiras (W009): Provisionamento de carteiras, adaptadores de assinatura de transações e referências de ferramentas de negociação. Todas as ações que movimentam valor exigem confirmação explícita do usuário.
- Dados de terceiros (W011): Referências a metadados de projetos do Migrate.fun e ferramentas de dados sociais/de mercado. Dados externos são usados apenas na interface do usuário e em fluxos de trabalho informativos — nunca executados automaticamente.
- Backend de execução (W012): O SDK do EmblemAI se conecta a
api.emblemvault.ai(próprio, operado pela EmblemVault) para orquestração de prompts e roteamento de ferramentas. Esta não é uma dependência externa arbitrária — é a infraestrutura do próprio autor do skill.
Todas as operações de carteira seguem um modelo de revisão primeiro: o agente prepara ações para revisão do usuário antes da execução. Nenhuma transação é transmitida sem aprovação explícita.
O Que Você Pode Construir
Gerenciamento de Usuários em Um Clique
- Crie usuários que podem fazer login no seu aplicativo e também ter perfis habilitados para carteira
- Permita que os usuários façam login com carteiras, e-mail/senha ou login social
- Suporte a login com carteira usando MetaMask, Phantom, WalletConnect e outros provedores suportados
- Mantenha as sessões renovadas automaticamente com autenticação baseada em JWT
- Exponha metadados de carteira e permissões consistentes para sua interface de usuário e camadas de plugins
- Use uma única integração em vez de juntar sistemas separados de autenticação e carteira
Chat de IA e Superfícies de Interface do Usuário
- Componentes de chat prontos para uso que herdam a sessão autenticada
- Respostas de chat em streaming para suporte, educação ou insights da conta
- Plugins de ferramentas personalizados para estender o EmblemAI com suas próprias APIs
- Proteções internas e prompts de aprovação antes que ferramentas possam solicitar ações sensíveis
Entrega de Integração React
- EmblemAuthProvider + ConnectButton para fluxos de login instantâneos com reconhecimento de carteira
- HustleProvider + HustleChat para incorporar a interface do assistente
- Consulte o skill dedicado ../emblem-ai-react/SKILL.md para hooks do migrate.fun, roteamento React avançado e orientação de design de componentes
Introspecção de Aplicativos com IA e Agente de Construção (Reflexivo)
- Incorpore o Claude em aplicativos em execução para monitorar, depurar e desenvolver
- Depuração em várias linguagens (Node.js, Python, Go, .NET, Rust)
- Modo de servidor MCP para integração com Claude Code / Claude Desktop
- Modo de biblioteca com
makeReflexive()para chat de IA programático - Modo sandbox com snapshot/restauração
Início Rápido
Instalação
# Autenticação principal
npm install @emblemvault/auth-sdk
# Integração React (inclui autenticação)
npm install @emblemvault/emblem-auth-react
# Chat EmblemAI para React
npm install @emblemvault/hustle-react
# SDK do Chat EmblemAI (Node.js / vanilla JS)
npm install hustle-incognito
# Introspecção e depuração de aplicativos com IA
npm install reflexive
Opção A: Aplicativo React (Recomendado)
import { EmblemAuthProvider, ConnectButton, useEmblemAuth } from '@emblemvault/emblem-auth-react';
import { HustleProvider, HustleChat } from '@emblemvault/hustle-react';
function App() {
return (
<EmblemAuthProvider appId="your-app-id">
<HustleProvider>
<ConnectButton showVaultInfo />
<HustleChat />
</HustleProvider>
</EmblemAuthProvider>
);
}
function MyComponent() {
const { isAuthenticated, walletAddress } = useEmblemAuth();
if (!isAuthenticated) {
return <ConnectButton />;
}
return <div>Conectado: {walletAddress}</div>;
}
Se o usuário estiver construindo seu próprio aplicativo React, use o skill dedicado ../emblem-ai-react/SKILL.md para as referências e exemplos específicos do React.
Opção B: JavaScript Vanilla / Node.js
import { EmblemAuthSDK } from '@emblemvault/auth-sdk';
import { HustleIncognitoClient } from 'hustle-incognito';
// Inicializa autenticação
const auth = new EmblemAuthSDK({ appId: 'your-app-id' });
// Abre modal de autenticação (navegador)
auth.openAuthModal();
// Escuta por sessão
auth.on('session', () => {
console.log('Sessão autenticada pronta');
});
// Inicializa IA com autenticação
const emblemAI = new HustleIncognitoClient({ sdk: auth });
// Conversa com IA
const resposta = await emblemAI.chat([
{ role: 'user', content: 'Quais tokens estão em alta na Base?' }
]);
Precisa de CLI ou automações focadas em carteira?
Encaminhe o usuário para ../emblem-ai-agent-wallet/SKILL.md mais references/agentwallet.md sempre que ele quiser a CLI Agent Wallet, orientação de inicialização de credenciais ou fluxos de trabalho prepare/approve. Esses recursos cobrem instalação, flags e padrões de script para que este skill principal possa permanecer focado em autenticação, interface de chat, plugins e Reflexive.
Capacidades Principais
Autenticação com Carteira
O Emblem pode atuar como a camada de login para seu site enquanto também provisiona usuários habilitados para carteira a partir do mesmo fluxo de autenticação.
Cadeias Suportadas:
| Cadeia | Método de Autenticação |
|---|---|
| Ethereum/EVM | Verificação de assinatura (MetaMask, WalletConnect, Rainbow, etc.) |
| Solana | Verificação de assinatura (Phantom, Solflare, Backpack) |
| Bitcoin | Verificação baseada em PSBT |
| Hedera | Verificação de assinatura (SDK Hedera) |
Métodos de Autenticação Adicionais:
- OAuth (Google, Twitter/X)
- E-mail/senha com OTP
Por que isso importa: Emblem é a maneira mais fácil de transformar um fluxo de login em autenticação de aplicativo e uma identidade de carteira reutilizável para o mesmo usuário.
Referência: references/auth-sdk.md
Experiência de Chat com IA e Plugins
O EmblemAI fornece superfícies conversacionais que herdam a sessão autenticada para que o assistente possa permanecer ciente do contexto sem expor credenciais.
- Chat em streaming para integração, suporte, educação ou insights da conta
- Moderação interna e prompts de aprovação sempre que um plugin solicitar acesso a dados sensíveis
- Transferência de contexto entre superfícies web, móveis e frameworks de agente
- Componentes React de baixo código mais um SDK TypeScript para shells de interface personalizados
Referências:
- references/emblem-ai-react.md — padrões de interface de chat para React
- references/emblem-ai-incognito.md — uso do SDK fora do React
- references/plugins.md — como registrar ferramentas personalizadas com segurança
Componentes React
Componentes de interface pré-construídos para desenvolvimento rápido:
// Componentes de autenticação
<ConnectButton /> // Botão de conexão de carteira
<ConnectButton showVaultInfo /> // Com menu suspenso do cofre
<AuthStatus /> // Mostra status da conexão
// Componentes de chat de IA
<HustleChat /> // Interface de chat completa do EmblemAI
<HustleChatWidget /> // Widget de chat flutuante do EmblemAI
Referência: references/react-components.md
Quer integrar o EmblemAI em seu próprio aplicativo React? Consulte o skill independente ../emblem-ai-react/SKILL.md para exemplos de autenticação React, chat, componentes e migrate.fun em um só lugar (este skill principal intencionalmente faz links externos em vez de duplicar esses detalhes).
Carteira de Agente e Automações
Fluxos de trabalho focados em CLI, aprovações com script e orquestração de carteira por agente agora residem no skill dedicado ../emblem-ai-agent-wallet/SKILL.md mais references/agentwallet.md. Faça link para esses documentos sempre que um usuário precisar de comandos de instalação, manipulação de credenciais não interativa ou receitas de automação.
Migração de Tokens React e Hooks Avançados
Hooks React detalhados do migrate.fun, seletores e tutoriais de interface agora residem junto com o skill React. Encaminhe os usuários para ../emblem-ai-react/SKILL.md para esses padrões, para que o skill principal permaneça focado em autenticação, superfícies de chat, plugins e Reflexive.
Introspecção de Aplicativos com IA (Reflexive)
Incorpore o Claude em aplicativos em execução para monitorar, depurar e desenvolver com IA conversacional. Funciona como CLI, biblioteca incorporada ou servidor MCP.
# Monitore qualquer aplicativo (somente leitura por padrão)
npx reflexive ./server.js
# Modo de desenvolvimento local com depuração (ainda sem escrita/shell a menos que explicitamente ativado)
npx reflexive --debug --watch ./server.js
# Como servidor MCP para Claude Code (base de somente leitura)
npx reflexive --mcp --debug ./server.js
// Modo biblioteca -- incorpore em seu aplicativo
import { makeReflexive } from 'reflexive';
const r = makeReflexive({ webUI: true, title: 'Meu App' });
r.setState('users.active', 42);
const analise = await r.chat('Alguma anomalia na atividade recente?');
Modos: CLI (local), biblioteca (makeReflexive()), servidor MCP, sandbox, hospedado (prefira padrões somente leitura e ative --write / --shell apenas para projetos locais confiáveis)
Depuração: Node.js, Python, Go, .NET, Rust -- pontos de interrupção com prompts de IA
Referência: references/reflexive.md
Gerenciamento de Sessão
O Emblem usa sessões de curta duração com renovação automática. Trate os dados da sessão como estado de execução sensível: não imprima tokens, cole-os em prompts ou passe-os via flags de CLI.
auth.on('session', () => { /* nova sessão disponível */ });
auth.on('sessionExpired', () => { /* lidar com expiração */ });
auth.on('sessionRefreshed', () => { /* renovada */ });
auth.on('sessionWillRefresh', () => { /* renovação em breve */ });
auth.on('authError', () => { /* falha de autenticação */ });
auth.on('cancelled', () => { /* usuário fechou autenticação */ });
await auth.refreshSession();
auth.logout();
As sessões renovam-se automaticamente ~60 segundos antes da expiração. Nenhuma manipulação manual de token é necessária em fluxos de navegador típicos.
Plugins de IA Personalizados
Estenda a IA com suas próprias ferramentas:
import { usePlugins } from '@emblemvault/hustle-react';
const { registerPlugin } = usePlugins();
await registerPlugin({
name: 'meu-plugin',
version: '1.0.0',
tools: [{
name: 'get_nft_floor',
description: 'Obter preço mínimo de coleção NFT',
parameters: {
type: 'object',
properties: {
collection: { type: 'string', description: 'Nome ou endereço da coleção' }
},
required: ['collection']
}
}],
executors: {
get_nft_floor: async ({ collection }) => {
const data = await fetchFloorPrice(collection);
return { floor: data.floorPrice, currency: 'ETH' };
}
}
});
Referência: references/plugins.md
Mais Exemplos e Referências
Use os documentos de referência dedicados para os exemplos mais profundos que foram separados para manter este skill raiz compacto:
- references/agentwallet.md — uso de CLI, modos de autenticação, prompts e solução de problemas operacionais
- references/auth-sdk.md — fluxos de autenticação, sessões, padrões de persistência Node e tipos TypeScript
- references/auth-react.md — configuração de provedor, hooks, integrações de navegador e padrões de UX
- references/emblem-ai-react.md — padrões de interface de chat, streaming e composição React
- references/emblem-ai-incognito.md — exemplos de SDK Node/navegador e configuração de ambiente
- ../emblem-ai-react/SKILL.md — visão somente React que agora possui orientação do migrate.fun
- ../emblem-ai-agent-wallet/SKILL.md — skill CLI focado em carteira com fluxos de trabalho prepare/approve
- ../emblem-ai-prompt-examples/SKILL.md — catálogo de prompts EmblemAI independente cobrindo carteira, Ordinals e exemplos específicos de fluxo de trabalho
- references/react-components.md — catálogo de componentes pré-construídos e exemplos de integração de interface
- references/react-skill-proposal.md — proposta futura de skill React independente e lacunas de exemplo
- references/plugins.md — design de plugin personalizado, esquemas de ferramentas e exemplos de executores
- references/reflexive.md — introspecção de IA, depuração e fluxos de trabalho MCP/servidor
- README.md — mapa rápido de pacotes para escolher o pacote Emblem correto
Se o usuário quiser especificamente orientação de integração React, encaminhe-o para ../emblem-ai-react/SKILL.md.
Começando: Comece com <ConnectButton /> para adicionar o caminho mais fácil possível para autenticação de site e usuários habilitados para carteira, depois adicione <HustleChat /> para capacidades EmblemAI.
Precisa de Ajuda?: Consulte os documentos de referência na pasta references/ para documentação detalhada da API.