EmblemAI 開発者ツール

ワンショットユーザー管理、ウォレット対応ユーザー、AI駆動暗号ワークフロー、およびアプリイントロスペクション用の EmblemAI 開発者ツール。

一文で説明すると： Emblem は、ユーザー管理、ウェブサイト認証、ウォレット対応ユーザーアカウントをアプリに追加する最も簡単な方法です。ウォレット、メール/パスワード、ソーシャルログインなどのサインインオプション、および組み込みチャットとイントロスペクションツールを備えています。

@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
• アシスタント UI を埋め込むための HustleProvider + HustleChat
• migrate.fun フック、高度な React ルーティング、およびコンポーネント設計ガイダンスについては、専用の ../emblem-ai-react/SKILL.md スキルを参照してください

AI アプリイントロスペクションとビルドエージェント (Reflexive)

• 実行中のアプリ内に Claude を埋め込んで、監視、デバッグ、開発を行います
• マルチ言語デバッグ (Node.js、Python、Go、.NET、Rust)
• Claude Code / Claude Desktop 統合向け MCP サーバーモード
• プログラム的な AI チャット向けライブラリモード (makeReflexive() を使用)
• スナップショット/リストア機能を備えたサンドボックスモード

クイックスタート

インストール

# コア認証
npm install @emblemvault/auth-sdk

# React 統合 (認証を含む)
npm install @emblemvault/emblem-auth-react

# React 向け EmblemAI チャット
npm install @emblemvault/hustle-react

# EmblemAI チャット SDK (Node.js / バニラ 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>Connected: {walletAddress}</div>;
}

ユーザーが独自の React アプリをビルドしている場合は、React 固有の参照とサンプルについて、専用の ../emblem-ai-react/SKILL.md スキルを使用してください。

オプション B：バニラ 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('Authenticated session ready');
});

// 認証で AI を初期化
const emblemAI = new HustleIncognitoClient({ sdk: auth });

// AI とチャット
const response = await emblemAI.chat([
  { role: 'user', content: 'What tokens are trending on Base?' }
]);

CLI またはウォレットファースト自動化が必要ですか？

ユーザーが Agent Wallet CLI、認証情報ブートストラップガイダンス、または準備/承認ワークフローを望んでいるときはいつでも、../emblem-ai-agent-wallet/SKILL.md と references/agentwallet.md にユーザーを指します。これらのリソースはインストール、フラグ、スクリプティングパターンをカバーしているため、このコアスキルは認証、チャット UI、プラグイン、および Reflexive に焦点を当てることができます。

コア機能

ウォレット認証

Emblem は、同じ認証フローからウォレット対応ユーザーをプロビジョニングしながら、ウェブサイトのログインレイヤーとして機能できます。

サポートされているチェーン：

チェーン	認証方法
Ethereum/EVM	署名検証 (MetaMask、WalletConnect、Rainbow など)
Solana	署名検証 (Phantom、Solflare、Backpack)
Bitcoin	PSBT ベースの検証
Hedera	署名検証 (Hedera SDK)

追加認証方法：

• OAuth (Google、Twitter/X)
• メール/パスワード (OTP 付き)

なぜこれが重要か： Emblem は、ログインフローを同じユーザーのアプリ認証と再利用可能なウォレットアイデンティティの両方に変える最も簡単な方法です。

参考資料：references/auth-sdk.md

AI チャット体験とプラグイン

EmblemAI は、認証されたセッションを継承する会話サーフェスを提供するため、アシスタントは認証情報を公開することなくコンテキスト認識を保つことができます。

• オンボーディング、サポート、教育、またはアカウント洞察のためのストリーミングチャット
• プラグインが機密データへのアクセスをリクエストするときはいつでも、組み込みモデレーションと承認プロンプト
• Web、モバイル、エージェントフレームワーク間でのクロスサーフェスコンテキストハンドオフ
• カスタム UI シェル用のローコード React コンポーネントと 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 アプリに統合したいですか？ React 認証、チャット、コンポーネント、および migrate.fun の例を 1 か所に集めた独立した ../emblem-ai-react/SKILL.md スキルを参照してください (このコアスキルはこれらの詳細を複製する代わりに意図的にリンクします)。

Agent Wallet と自動化

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('Any anomalies in recent activity?');

モード：CLI (ローカル)、ライブラリ (makeReflexive())、MCP サーバー、サンドボックス、ホスト (読み取り専用デフォルトを推奨し、信頼できるローカルプロジェクトの場合のみ --write / --shell を有効化)

デバッグ：Node.js、Python、Go、.NET、Rust -- AI プロンプト付きブレークポイント

参考資料：references/reflexive.md

セッション管理

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: 'Get NFT collection floor price',
    parameters: {
      type: 'object',
      properties: {
        collection: { type: 'string', description: 'Collection name or address' }
      },
      required: ['collection']
    }
  }],
  executors: {
    get_nft_floor: async ({ collection }) => {
      const data = await fetchFloorPrice(collection);
      return { floor: data.floorPrice, currency: 'ETH' };
    }
  }
});

参考資料：references/plugins.md

さらに多くの例と参考資料

このルートスキルをコンパクトに保つために分割された詳細な例については、専用の参考資料ドキュメントを使用してください：

• 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 - 準備/承認ワークフロー付きウォレットファースト 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 /> で始めて、ウェブサイト認証とウォレット対応ユーザーへの最も簡単なパスを追加します。次に <HustleChat /> を追加して、EmblemAI 機能を追加します。

ヘルプが必要ですか？：references/ フォルダーの参考資料で詳細な API ドキュメントを確認してください。