Accept a Wallet Share

Accepts a wallet share invitation from another user, granting access to the shared wallet according to the permissions specified by the sharing user.

Wallet Share Permissions

• View: Read-only access to wallet information and transactions
• Spend: Ability to create and sign transactions
• Admin: Full control including user management and settings

Acceptance Workflow

The acceptance process varies based on the share type:

1. View-Only Shares

No encryption processing needed. The share is accepted immediately without requiring userPassword.

2. Spend/Admin Shares with Keychain (Standard Path)

Uses ECDH (Elliptic Curve Diffie-Hellman) key sharing:

• Requires userPassword to decrypt your ECDH keychain
• Derives a shared secret between you and the sharing user
• Decrypts the shared wallet keys using this secret
• Re-encrypts the keys with newWalletPassphrase (or userPassword if not specified)
• Stores the encrypted keys for future wallet operations

3. Override Path (Out-of-Band Key Exchange)

When overrideEncryptedXprv is provided:

• Bypasses the ECDH key derivation process
• Uses the pre-encrypted xprv directly
• No password required (keys are already encrypted)

Security Notes

• userPassword must match your BitGo account password
• newWalletPassphrase should be strong and securely stored
• The ECDH key exchange ensures only the intended recipient can decrypt the wallet keys
• overrideEncryptedXprv should only be used for keys received through a separate secure channel