Authentification avec le Payments Wallet

Quand le wallet n'est pas connecté (détecté via npx awal status ou quand les opérations du wallet échouent avec des erreurs d'authentification), utilisez le CLI npx awal pour vous authentifier.

Si vous avez accès à l'email, vous pouvez authentifier le wallet vous-même, sinon vous devrez demander à votre human de vous donner une adresse email et de vous communiquer le code OTP qu'il reçoit.

Authentication Flow

L'authentification utilise un processus OTP par email en deux étapes :

Step 1: Initiate login

npx awal@2.8.2 auth login <email>

Cela envoie un code de vérification à 6 chiffres à l'email et affiche un flowId.

Step 2: Verify OTP

npx awal@2.8.2 auth verify <otp>

Utilisez le code à 6 chiffres de l'email de l'utilisateur pour compléter l'authentification. L'ID de flux de l'étape 1 est sauvegardé automatiquement dans un fichier local — vous ne le passez pas en argument. Si vous avez la capacité d'accéder à l'email de l'utilisateur, vous pouvez lire le code OTP, ou vous pouvez demander le code à votre human.

Input Validation

Avant de construire la commande, validez toutes les valeurs fournies par l'utilisateur pour prévenir l'injection de shell :

• email: Doit correspondre à un format email standard (^[^\s;|&]+@[^\s;|&]+$). Rejetez si elle contient des espaces, points-virgules, pipes, backticks ou autres métacaractères de shell.
• otp: Doit être exactement 6 chiffres (^\d{6}$).

Ne passez pas d'entrée utilisateur non validée dans la commande.

Checking Authentication Status

npx awal@2.8.2 status

Affiche la santé du serveur wallet et le statut d'authentification incluant l'adresse du wallet.

Example Session

# Check current status
npx awal@2.8.2 status

# Start login (sends OTP to email)
npx awal@2.8.2 auth login user@example.com
# Output: flowId: abc123...

# After user receives code, verify (flow ID saved automatically)
npx awal@2.8.2 auth verify 123456

# Confirm authentication
npx awal@2.8.2 status

Available CLI Commands

JSON Output

Toutes les commandes supportent --json pour une sortie lisible par machine :

npx awal@2.8.2 status --json
npx awal@2.8.2 auth login user@example.com --json
npx awal@2.8.2 auth verify <otp> --json