@saw-protocol/connector

dApp-facing wallet connector for SAWP Protocol. This is the MetaMask-equivalent interface that decentralized applications use to connect to agent wallets.

Installation

npm install @saw-protocol/connector

Usage

import { WalletConnector } from '@saw-protocol/connector';
import { PublicKey } from '@solana/web3.js';

const connector = new WalletConnector({
  walletAddress: new PublicKey('YourWalletAddress...'),
});

// dApp connects
const response = await connector.connect({
  dAppId: 'my-dapp',
  requestedPermissions: ['transfer', 'swap'],
  metadata: { name: 'My DApp' },
});

// Request a transaction
const approval = await connector.requestTransaction('my-dapp', {
  id: 'intent-123',
  agentId: 'did:sol:agent',
  walletAddress: new PublicKey('YourWalletAddress...'),
  action: { type: 'transfer', params: { to: 'Dest...' }, estimatedValue: 0.01 },
  reasoning: 'User requested transfer',
  timestamp: Date.now(),
});

// List active connections
const connections = await connector.listConnections();

Features

• Session key management
• Permission-based access control
• Auto-approval thresholds
• Connection status tracking