Portefeuille OpenSea
Configurez les fournisseurs de signature de portefeuille pour les transactions OpenSea. Le CLI et le SDK détectent automatiquement le fournisseur à utiliser en fonction des variables d'environnement, ou vous pouvez en spécifier un explicitement avec --wallet-provider.
Quand utiliser cette compétence (scope_in)
Utilisez opensea-wallet quand vous avez besoin de :
- Configurer un fournisseur de portefeuille pour la première fois (Privy, Turnkey, Fireblocks, Bankr, ou clés locales)
- Configurer des politiques de signature (plafonds de valeur, listes blanches, approbation multi-parties)
- Basculer entre les fournisseurs de portefeuille
- Comprendre le modèle de sécurité pour chaque fournisseur
Quand NE PAS utiliser cette compétence (scope_out, handoff)
| Besoin | Utilisez à la place |
|---|---|
| Interroger les données NFT/token | opensea-api |
| Acheter/vendre des NFT | opensea-marketplace |
| Échanger des tokens ERC20 | opensea-swaps |
| Créer/enregistrer/gate les outils d'agent IA | opensea-tool-sdk |
Démarrage rapide
# 1. Choisissez un fournisseur géré et définissez ses variables d'environnement (Privy par défaut)
export OPENSEA_API_KEY=your_key
export PRIVY_APP_ID=your_app_id
export PRIVY_APP_SECRET=your_app_secret
export PRIVY_WALLET_ID=your_wallet_id
# 2. Utilisez le portefeuille via n'importe quelle commande compatible avec la signature
opensea swaps execute \
--from-chain base --from-address 0x0000000000000000000000000000000000000000 \
--to-chain base --to-address 0xb695559b26bb2c9703ef1935c37aeae9526bab07 \
--quantity 0.001Pour les autres fournisseurs, voir le tableau ci-dessous et references/wallet-setup.md.
Fournisseurs supportés
| Fournisseur | Variables d'environnement | Idéal pour |
|---|---|---|
| Privy (défaut) | PRIVY_APP_ID, PRIVY_APP_SECRET, PRIVY_WALLET_ID |
Politiques appliquées par TEE, portefeuilles intégrés |
| Turnkey | TURNKEY_API_PUBLIC_KEY, TURNKEY_API_PRIVATE_KEY, TURNKEY_ORGANIZATION_ID, TURNKEY_WALLET_ADDRESS |
Clés sauvegardées par HSM, approbation multi-parties |
| Fireblocks | FIREBLOCKS_API_KEY, FIREBLOCKS_API_SECRET, FIREBLOCKS_VAULT_ID |
Garde MPC d'entreprise, utilisation institutionnelle |
| Bankr | BANKR_API_KEY |
Portefeuilles d'agent via l'API de signature HTTP de Bankr |
| Clé privée (dev local uniquement) | PRIVATE_KEY, RPC_URL, WALLET_ADDRESS |
Dev/tests locaux uniquement (aucune limite de dépense ni garde-fou) |
Le CLI et le SDK gèrent automatiquement la signature une fois les variables d'environnement définies. Ordre de détection automatique : Privy, Fireblocks, Turnkey, Bankr, Clé privée. Pour spécifier un fournisseur explicitement :
opensea swaps execute --wallet-provider turnkey ...
opensea swaps execute --wallet-provider fireblocks ...
opensea swaps execute --wallet-provider bankr ...
opensea swaps execute --wallet-provider private-key ...Sécurité
- Les fournisseurs gérés (Privy, Turnkey, Fireblocks, Bankr) sont fortement recommandés par rapport aux clés privées brutes.
- La
PRIVATE_KEYbrute est réservée au développement local uniquement. Ne collez jamais une clé privée brute dans un environnement d'agent partagé, un CI hébergé, ou tout contexte où la clé pourrait être enregistrée ou exfiltrée. - Les configurations de production et d'agent partagé doivent utiliser un fournisseur géré avec des politiques de signature conservatrices (plafonds de valeur, listes blanches, approbation multi-parties).
Références
references/wallet-setup.md: instructions de configuration détaillées pour chaque fournisseurreferences/wallet-policies.md: configuration de la politique pour les limites de signature et les listes blanches- OpenSea CLI