MockWalletAdapter

SIP Protocol API Reference / MockWalletAdapter

Class: MockWalletAdapter

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9016

Mock wallet adapter for testing

Provides a complete wallet implementation with mock data. Useful for testing and development without real wallet connections.

Example

const mockWallet = new MockWalletAdapter({
  chain: 'solana',
  address: 'SoLaNaAddReSS...',
  balance: 1000000000n, // 1 SOL
})

await mockWallet.connect()
const balance = await mockWallet.getBalance()

Extends

BaseWalletAdapter

Constructors

Constructor

new MockWalletAdapter(options): MockWalletAdapter

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9025

Parameters

options

chain

ChainId

address?

string

publicKey?

`0x${string}`

balance?

bigint

tokenBalances?

Record<string, bigint>

name?

string

shouldFailConnect?

boolean

shouldFailSign?

boolean

Returns

MockWalletAdapter

Overrides

BaseWalletAdapter.constructor

Properties

chain

readonly chain: ChainId

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9017

Chain this adapter connects to

Overrides

BaseWalletAdapter.chain

name

readonly name: string

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9018

Wallet name/identifier (e.g., ‘phantom’, ‘metamask’)

Overrides

BaseWalletAdapter.name

Accessors

address

Get Signature

get address(): string

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:8930

Current address (empty string if not connected)

Returns

string

Current address (empty string if not connected)

Inherited from

BaseWalletAdapter.address

publicKey

Get Signature

get publicKey(): "" | `0x${string}`

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:8931

Public key (hex encoded, empty string if not connected)

Returns

"" | `0x${string}`

Public key (hex encoded, empty string if not connected)

Inherited from

BaseWalletAdapter.publicKey

connectionState

Get Signature

get connectionState(): WalletConnectionState

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:8932

Current connection state

Returns

WalletConnectionState

Current connection state

Inherited from

BaseWalletAdapter.connectionState

Methods

on()

on<T>(event, handler): void

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:8937

Subscribe to wallet events

Type Parameters

T

T extends WalletEventType

Parameters

event

T

handler

WalletEventHandler<Extract<WalletConnectEvent, { type: T; }> | Extract<WalletDisconnectEvent, { type: T; }> | Extract<WalletAccountChangedEvent, { type: T; }> | Extract<WalletChainChangedEvent, { type: T; }> | Extract<WalletErrorEvent, { type: T; }>>

Returns

void

Inherited from

BaseWalletAdapter.on

off()

off<T>(event, handler): void

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:8943

Unsubscribe from wallet events

Type Parameters

T

T extends WalletEventType

Parameters

event

T

handler

Returns

void

Inherited from

BaseWalletAdapter.off

isConnected()

isConnected(): boolean

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:8973

Check if wallet is connected

Returns

boolean

Inherited from

BaseWalletAdapter.isConnected

connect()

connect(): Promise<void>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9035

Connect to the wallet

Returns

Promise<void>

Throws

If connection fails

Overrides

BaseWalletAdapter.connect

disconnect()

disconnect(): Promise<void>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9036

Disconnect from the wallet

Returns

Promise<void>

Overrides

BaseWalletAdapter.disconnect

signMessage()

signMessage(message): Promise<Signature>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9037

Sign an arbitrary message

Parameters

message

Uint8Array

The message bytes to sign

Returns

Promise<Signature>

The signature

Throws

If signing fails or wallet not connected

Overrides

BaseWalletAdapter.signMessage

signTransaction()

signTransaction(tx): Promise<SignedTransaction>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9038

Sign a transaction

Parameters

tx

UnsignedTransaction

The unsigned transaction

Returns

Promise<SignedTransaction>

The signed transaction

Throws

If signing fails or wallet not connected

Overrides

BaseWalletAdapter.signTransaction

signAndSendTransaction()

signAndSendTransaction(tx): Promise<TransactionReceipt>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9039

Sign and broadcast a transaction

Parameters

tx

UnsignedTransaction

The unsigned transaction

Returns

Promise<TransactionReceipt>

The transaction receipt

Throws

If signing or broadcast fails

Overrides

BaseWalletAdapter.signAndSendTransaction

getBalance()

getBalance(): Promise<bigint>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9040

Get native token balance

Returns

Promise<bigint>

Balance in smallest unit (lamports, wei, etc.)

Throws

If query fails

Overrides

BaseWalletAdapter.getBalance

getTokenBalance()

getTokenBalance(asset): Promise<bigint>

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9041

Get token balance for a specific asset

Parameters

asset

Asset

The asset to query balance for

Returns

Promise<bigint>

Balance in smallest unit

Throws

If query fails or asset not supported

Overrides

BaseWalletAdapter.getTokenBalance

setMockBalance()

setMockBalance(balance): void

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9045

Set mock balance (for testing)

Parameters

balance

bigint

Returns

void

setMockTokenBalance()

setMockTokenBalance(asset, balance): void

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9049

Set mock token balance (for testing)

Parameters

asset

Asset

balance

bigint

Returns

void

simulateAccountChange()

simulateAccountChange(newAddress): void

Defined in: @sip-protocol/sdk/dist/index-BYZbDjal.d.ts:9053

Simulate account change (for testing)

Parameters

newAddress

string

Returns

void