Connect SDK

Appearance

@swapped/connect-sdk / wallet-verification / WalletVerification

Type Alias: WalletVerification ​

WalletVerification = object

Defined in: src/types/wallet-verification.types.ts:138

Mapped verification record returned by create, proof, get, and verify().

Identity for reuse / cache: customerId + address. If that pair is already verified, create returns status: "verified" and challenge: null.

Example ​

ts
// Pending signature create
{
  verificationId: 'b6f3c2a1-0000-4000-8000-000000000001',
  status: 'pending',
  method: 'signature',
  network: 'evm',
  address: '0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B',
  orderId: 'order-9876',
  verifiedAt: null,
  challenge: {
    message: 'Sweeper: I confirm I control wallet address 0xAb58…',
    authorizationUrl: null,
    nonce: 'n7k2…',
    expiresAt: '2026-09-02T12:15:00.000Z',
  },
}

// Terminal GET - API omits challenge; SDK normalizes it to null
{
  verificationId: 'b6f3c2a1-0000-4000-8000-000000000001',
  status: 'verified',
  method: 'signature',
  network: 'evm',
  address: '0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B',
  orderId: null,
  verifiedAt: '2026-09-04T13:08:25.397Z',
  challenge: null,
}

Properties ​

address ​

address: string

Defined in: src/types/wallet-verification.types.ts:170

Address the user claimed to control.

Example ​

ts
`'0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B'`

challenge ​

challenge: WalletVerificationChallenge | null

Defined in: src/types/wallet-verification.types.ts:187

Pending proof payload, or null when the record is terminal / the API omitted it. See WalletVerificationChallenge.

method ​

method: WalletVerificationMethod

Defined in: src/types/wallet-verification.types.ts:157

How this record is proved - see WalletVerificationMethod.

Example ​

ts
`'signature'`

network ​

network: WalletVerificationNetwork

Defined in: src/types/wallet-verification.types.ts:164

Chain family of WalletVerification.address. Signature today: evm and solana.

Example ​

ts
`'evm'`

orderId ​

orderId: string | null

Defined in: src/types/wallet-verification.types.ts:176

Merchant order reference (metadata only). null when omitted on create.

Example ​

ts
`'order-9876'`

status ​

status: WalletVerificationStatus

Defined in: src/types/wallet-verification.types.ts:151

Lifecycle. Branch UI on this - see WalletVerificationStatus.

Example ​

ts
`'pending'`

verificationId ​

verificationId: string

Defined in: src/types/wallet-verification.types.ts:145

Server id. Use this to poll, submit proof, or read ?verificationId= after Coinbase redirect.

Example ​

ts
`'b6f3c2a1-0000-4000-8000-000000000001'`

verifiedAt ​

verifiedAt: string | null

Defined in: src/types/wallet-verification.types.ts:182

ISO timestamp once status is verified; otherwise null.

Example ​

ts
`'2026-09-04T13:08:25.397Z'`