EmblemAI 開発者ツール は何をしますか?
EmblemAI 開発者ツールは、ワンショットのユーザー管理、ウォレット対応ユーザー、AI 駆動の暗号資産ワークフロー、アプリ内省を実現します。
一言で言うと: Emblem は、アプリにユーザー管理、Web サイト認証、ウォレット対応ユーザーアカウントを追加する最も簡単な方法であり、ウォレット、メール/パスワード、ソーシャルログインによるサインインオプションと、組み込みのチャットおよび内省ツールを提供します。
@emblemvault/hustle-react や hustle-incognito などのレガシーパッケージ名は、現在の統合インターフェースの一部として引き続き維持されています。
セキュリティと信頼モデル
このスキルは、暗号資産ウォレット認証と AI 駆動アシスタント機能について説明します。これには本質的に以下が含まれます:
- 金融操作 (W009): ウォレットプロビジョニング、トランザクション署名アダプター、およびトレーディングツールへの参照。価値を移動するすべてのアクションには、ユーザーの明示的な確認が必要です。
- サードパーティデータ (W011): Migrate.fun プロジェクトメタデータおよびソーシャル/マーケットデータツールへの参照。外部データは UI および情報提供のワークフローにのみ使用され、自動実行はされません。
- ランタイムバックエンド (W012): EmblemAI SDK は
api.emblemvault.ai(EmblemVault が運営するファーストパーティ)に接続し、プロンプトのオーケストレーションとツールルーティングを行います。これは任意の外部依存関係ではなく、スキル作成者自身のインフラストラクチャです。
すべてのウォレット操作は レビュー優先 モデルに従います。エージェントは実行前にアクションを準備し、ユーザーが確認します。明示的な承認なしにトランザクションがブロードキャストされることはありません。
構築できるもの
ワンショットユーザー管理
- アプリにログインでき、ウォレット対応プロファイルを持つユーザーを作成
- ユーザーにウォレット、メール/パスワード、またはソーシャルログインでのサインインを許可
- MetaMask、Phantom、WalletConnect、およびその他のサポートプロバイダーによるウォレットログインをサポート
- JWT ベースの認証でセッションを自動更新
- 一貫したウォレットメタデータと権限を UI およびプラグインレイヤーに公開
- 個別の認証システムとウォレットシステムを統合する代わりに、1 つの統合を使用
AI チャットと UI サーフェス
- 認証されたセッションを継承するドロップイン型チャットコンポーネント
- サポート、教育、アカウントインサイトのためのストリーミングチャット応答
- カスタムツールプラグインを使用して EmblemAI を独自の API で拡張
- ツールが機密アクションを要求する前に、組み込みのガードレールと承認プロンプト
React 統合ハンドオフ
- EmblemAuthProvider + ConnectButton によるインスタントウォレット認識ログインフロー
- HustleProvider + HustleChat によるアシスタント UI の埋め込み
- migrate.fun フック、高度な React ルーティング、コンポーネント設計ガイダンスについては、専用の ../emblem-ai-react/SKILL.md スキルを参照
AI アプリ内省とビルドエージェント (Reflexive)
- 実行中のアプリに Claude を埋め込み、監視、デバッグ、開発を実行
- マルチ言語デバッグ (Node.js、Python、Go、.NET、Rust)
- Claude Code / Claude Desktop 統合用の MCP サーバーモード
makeReflexive()によるプログラム的な AI チャットのライブラリモード- スナップショット/リストア機能付きサンドボックスモード
クイックスタート
インストール
# コア認証
npm install @emblemvault/auth-sdk
# React 統合 (認証を含む)
npm install @emblemvault/emblem-auth-react
# React 用 EmblemAI チャット
npm install @emblemvault/hustle-react
# EmblemAI チャット SDK (Node.js / Vanilla JS)
npm install hustle-incognito
# AI アプリ内省とデバッグ
npm install reflexive
オプション A: React アプリ (推奨)
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>接続済み: {walletAddress}</div>;
}
ユーザーが独自の React アプリを構築している場合は、React 固有の参照と例について専用の ../emblem-ai-react/SKILL.md スキルを使用してください。
オプション B: Vanilla JavaScript / Node.js
import { EmblemAuthSDK } from '@emblemvault/auth-sdk';
import { HustleIncognitoClient } from 'hustle-incognito';
// 認証の初期化
const auth = new EmblemAuthSDK({ appId: 'your-app-id' });
// 認証モーダルを開く (ブラウザ)
auth.openAuthModal();
// セッションをリッスン
auth.on('session', () => {
console.log('認証セッション準備完了');
});
// 認証付きで AI を初期化
const emblemAI = new HustleIncognitoClient({ sdk: auth });
// AI とチャット
const response = await emblemAI.chat([
{ role: 'user', content: 'Base でトレンドのトークンは何ですか?' }
]);
CLI やウォレットファーストの自動化が必要ですか?
ユーザーが Agent Wallet CLI、クレデンシャルブートストラップガイダンス、または prepare/approve ワークフローを必要とする場合は、../emblem-ai-agent-wallet/SKILL.md および references/agentwallet.md を参照するよう案内してください。これらのリソースはインストール、フラグ、スクリプトパターンをカバーしており、このコアスキルは認証、チャット UI、プラグイン、Reflexive に集中できます。
コア機能
ウォレット認証
Emblem は Web サイトのログインレイヤーとして機能すると同時に、同じ認証フローからウォレット対応ユーザーをプロビジョニングできます。
サポートチェーン:
| チェーン | 認証方法 |
|---|---|
| Ethereum/EVM | 署名検証 (MetaMask、WalletConnect、Rainbow など) |
| Solana | 署名検証 (Phantom、Solflare、Backpack) |
| Bitcoin | PSBT ベースの検証 |
| Hedera | 署名検証 (Hedera SDK) |
その他の認証方法:
- OAuth (Google、Twitter/X)
- メール/パスワード + OTP
なぜこれが重要なのか: Emblem は、ログインフローをアプリ認証と、同じユーザーの再利用可能なウォレット ID の両方に変換する最も簡単な方法です。
AI チャット体験とプラグイン
EmblemAI は、認証されたセッションを継承する会話型サーフェスを提供し、アシスタントが資格情報を公開せずにコンテキストを認識できるようにします。
- オンボーディング、サポート、教育、アカウントインサイトのためのストリーミングチャット
- プラグインが機密データへのアクセスを要求するたびに、組み込みのモデレーションと承認プロンプト
- Web、モバイル、エージェントフレームワーク間のクロスサーフェスコンテキストハンドオフ
- ローコードの React コンポーネントと、カスタム UI シェル用の TypeScript SDK
参照:
- references/emblem-ai-react.md — React のチャット UI パターン
- references/emblem-ai-incognito.md — React 以外での SDK 使用法
- references/plugins.md — カスタムツールを安全に登録する方法
React コンポーネント
迅速な開発のための事前構築済み UI コンポーネント:
// 認証コンポーネント
<ConnectButton /> // ウォレット接続ボタン
<ConnectButton showVaultInfo /> // ボールトドロップダウン付き
<AuthStatus /> // 接続状態を表示
// AI チャットコンポーネント
<HustleChat /> // 完全な EmblemAI チャットインターフェース
<HustleChatWidget /> // フローティング EmblemAI チャットウィジェット
参照: references/react-components.md
EmblemAI を独自の React アプリに統合したいですか? スタンドアロンの ../emblem-ai-react/SKILL.md スキルを参照してください。そこでは、React 認証、チャット、コンポーネント、migrate.fun の例が 1 か所にまとめられています(このコアスキルは、詳細を重複させる代わりに意図的にリンクを外部に提供しています)。
エージェントウォレットと自動化
CLI ファーストのワークフロー、スクリプト化された承認、ウォレットパーエージェントのオーケストレーションは、専用の ../emblem-ai-agent-wallet/SKILL.md スキルと references/agentwallet.md に移動しました。ユーザーがインストールコマンド、非インタラクティブな資格情報処理、自動化レシピを必要とする場合は、それらのドキュメントにリンクしてください。
React トークンマイグレーションと高度なフック
詳細な migrate.fun React フック、セレクター、UI ウォークスルーは、React スキルとともに移動しました。これらのパターンについては、ユーザーを ../emblem-ai-react/SKILL.md に誘導し、コアスキルは認証、チャットサーフェス、プラグイン、Reflexive に集中し続けられるようにします。
AI アプリ内省 (Reflexive)
実行中のアプリケーションに Claude を埋め込み、会話型 AI で監視、デバッグ、開発を実行します。CLI、埋め込みライブラリ、または MCP サーバーとして動作します。
# 任意のアプリを監視 (デフォルトは読み取り専用)
npx reflexive ./server.js
# デバッグ付きローカル開発モード (明示的に有効にしない限り、書き込み/シェルはなし)
npx reflexive --debug --watch ./server.js
# Claude Code 用 MCP サーバーとして (ベースラインは読み取り専用)
npx reflexive --mcp --debug ./server.js
// ライブラリモード -- アプリに埋め込む
import { makeReflexive } from 'reflexive';
const r = makeReflexive({ webUI: true, title: 'My App' });
r.setState('users.active', 42);
const analysis = await r.chat('最近のアクティビティに異常はありますか?');
モード: CLI (ローカル)、ライブラリ (makeReflexive())、MCP サーバー、サンドボックス、ホステッド(読み取り専用デフォルトを推奨し、信頼できるローカルプロジェクトにのみ --write / --shell を有効化)
デバッグ: Node.js、Python、Go、.NET、Rust -- AI プロンプトによるブレークポイント
セッション管理
Emblem は自動更新付きの短期セッションを使用します。セッションデータは機密性の高いランタイム状態として扱い、トークンを印刷したり、プロンプトに貼り付けたり、CLI フラグで渡したりしないでください。
auth.on('session', () => { /* 新しいセッション利用可能 */ });
auth.on('sessionExpired', () => { /* 期限切れを処理 */ });
auth.on('sessionRefreshed', () => { /* 更新完了 */ });
auth.on('sessionWillRefresh', () => { /* まもなく更新 */ });
auth.on('authError', () => { /* 認証失敗 */ });
auth.on('cancelled', () => { /* ユーザーが認証を閉じた */ });
await auth.refreshSession();
auth.logout();
セッションは期限切れの約 60 秒前に自動更新されます。通常のブラウザフローでは手動のトークン処理は必要ありません。
カスタム AI プラグイン
独自のツールで AI を拡張:
import { usePlugins } from '@emblemvault/hustle-react';
const { registerPlugin } = usePlugins();
await registerPlugin({
name: 'my-plugin',
version: '1.0.0',
tools: [{
name: 'get_nft_floor',
description: 'NFT コレクションのフロア価格を取得',
parameters: {
type: 'object',
properties: {
collection: { type: 'string', description: 'コレクション名またはアドレス' }
},
required: ['collection']
}
}],
executors: {
get_nft_floor: async ({ collection }) => {
const data = await fetchFloorPrice(collection);
return { floor: data.floorPrice, currency: 'ETH' };
}
}
});
その他の例と参照
このルートスキルをコンパクトに保つために分割された、より深い例については専用の参照ドキュメントを使用してください:
- references/agentwallet.md - CLI 使用法、認証モード、プロンプト、運用トラブルシューティング
- references/auth-sdk.md - 認証フロー、セッション、Node 永続化パターン、TypeScript 型
- references/auth-react.md - プロバイダー設定、フック、ブラウザ統合、UX パターン
- references/emblem-ai-react.md - チャット UI パターン、ストリーミング、React 構成
- references/emblem-ai-incognito.md - Node/ブラウザ SDK の例と環境設定
- ../emblem-ai-react/SKILL.md - migrate.fun ガイダンスを担当する React 専用ビュー
- ../emblem-ai-agent-wallet/SKILL.md - prepare/approve ワークフローを含むウォレットファースト CLI スキル
- ../emblem-ai-prompt-examples/SKILL.md - ウォレット、Ordinals、ワークフロー固有の例をカバーするスタンドアロン EmblemAI プロンプトカタログ
- references/react-components.md - 事前構築済みコンポーネントカタログと UI 統合例
- references/react-skill-proposal.md - 提案された将来の React スタンドアロンスキルの境界と例のギャップ
- references/plugins.md - カスタムプラグイン設計、ツールスキーマ、エグゼキュータの例
- references/reflexive.md - AI 内省、デバッグ、MCP/サーバーワークフロー
- README.md - 適切な Emblem パッケージを選択するためのクイックパッケージマップ
ユーザーが特に React 統合ガイダンスを必要とする場合は、../emblem-ai-react/SKILL.md を参照するよう案内してください。
はじめに: <ConnectButton /> から始めて、Web サイト認証とウォレット対応ユーザーへの最も簡単なパスを追加し、次に <HustleChat /> を追加して EmblemAI 機能を利用します。
ヘルプが必要ですか?: 詳細な API ドキュメントについては、references/ フォルダ内の参照ドキュメントを確認してください。