Class SignerEvm`Abstract`

An abstract class extending Signer for Ethereum Virtual Machine (EVM) based signing operations. This class provides methods to get EVM account, internal address, and signing transactions.

Hierarchy (View Summary)

Signer
- SignerEvm

Constructors

constructor

new SignerEvm(client_: Client): SignerEvm
Parameters
- client_: Client
Returns SignerEvm
Inherited from Signer.constructor
- Defined in signer/signer/index.ts:82

Properties

`Protected`client_

client_: Client

Accessors

type

get type(): SignerType
Returns SignerType
Overrides Signer.type
- Defined in signer/evm/signerEvm.ts:22

signType

get signType(): SignerSignType
Returns SignerSignType
Overrides Signer.signType
- Defined in signer/evm/signerEvm.ts:26

client

get client(): Client
Returns Client
Inherited from Signer.client
- Defined in signer/signer/index.ts:87

Methods

`Abstract`getEvmAccount

getEvmAccount(): Promise<`0x${string}`>
Gets the EVM account associated with the signer.

Returns Promise<`0x${string}`>
A promise that resolves to a string representing the EVM account.
- Defined in signer/evm/signerEvm.ts:35

getInternalAddress

getInternalAddress(): Promise<string>
Gets the internal address, which is the EVM account in this case.

Returns Promise<string>
A promise that resolves to a string representing the internal address.
Overrides Signer.getInternalAddress
- Defined in signer/evm/signerEvm.ts:42

getAddressObjs

getAddressObjs(): Promise<Address[]>
Gets an array of Address objects representing the known script addresses for the signer.

Returns Promise<Address[]>
A promise that resolves to an array of Address objects.
Overrides Signer.getAddressObjs
- Defined in signer/evm/signerEvm.ts:51

_getOmniLockAddresses

_getOmniLockAddresses(account: BytesLike): Promise<Address[]>
Parameters
- account: BytesLike
Returns Promise<Address[]>
- Defined in signer/evm/signerEvm.ts:61

_getPWLockAddresses

_getPWLockAddresses(account: BytesLike): Promise<Address[]>
Parameters
- account: BytesLike
Returns Promise<Address[]>
- Defined in signer/evm/signerEvm.ts:68

_getOmniLockEvmAddressObj

_getOmniLockEvmAddressObj(account: BytesLike): Promise<Address>
Parameters
- account: BytesLike
Returns Promise<Address>
- Defined in signer/evm/signerEvm.ts:76

_getOmniLockOldEvmAddressObj

_getOmniLockOldEvmAddressObj(account: BytesLike): Promise<Address>
Parameters
- account: BytesLike
Returns Promise<Address>
- Defined in signer/evm/signerEvm.ts:84

_getPWLockEvmAddressObj

_getPWLockEvmAddressObj(account: BytesLike): Promise<undefined | Address>
Parameters
- account: BytesLike
Returns Promise<undefined | Address>
- Defined in signer/evm/signerEvm.ts:92

prepareTransaction

prepareTransaction(txLike: TransactionLike): Promise<Transaction>
prepare a transaction before signing. This method is not implemented and should be overridden by subclasses.
Parameters
- txLike: TransactionLike
  The transaction to prepare, represented as a TransactionLike object.
Returns Promise<Transaction>
A promise that resolves to the prepared Transaction object.
Overrides Signer.prepareTransaction
- Defined in signer/evm/signerEvm.ts:111

signOnlyTransaction

signOnlyTransaction(txLike: TransactionLike): Promise<Transaction>
Signs a transaction without modifying it.
Parameters
- txLike: TransactionLike
  The transaction to sign, represented as a TransactionLike object.
Returns Promise<Transaction>
A promise that resolves to a signed Transaction object.
Overrides Signer.signOnlyTransaction
- Defined in signer/evm/signerEvm.ts:155

_signOmniLockScriptForTransaction

_signOmniLockScriptForTransaction(
    tx: Transaction,
    script: Script,
    messageTransformer: (hash: string) => BytesLike,
): Promise<Transaction>
Parameters
- tx: Transaction
- script: Script
- messageTransformer: (hash: string) => BytesLike
Returns Promise<Transaction>
- Defined in signer/evm/signerEvm.ts:186

_signPWLockScriptForTransaction

_signPWLockScriptForTransaction(
    tx: Transaction,
    script: Script,
    messageTransformer: (hash: string) => BytesLike,
): Promise<Transaction>
Parameters
- tx: Transaction
- script: Script
- messageTransformer: (hash: string) => BytesLike
Returns Promise<Transaction>
- Defined in signer/evm/signerEvm.ts:217

_signPersonalEvmForTransaction

_signPersonalEvmForTransaction(
    tx: Transaction,
    script: Script,
    messageTransformer: (hash: string) => BytesLike,
    hasher?: Hasher,
): Promise<undefined | { signature: Bytes; position: number }>
Parameters
- tx: Transaction
- script: Script
- messageTransformer: (hash: string) => BytesLike
- Optionalhasher: Hasher
Returns Promise<undefined | { signature: Bytes; position: number }>
- Defined in signer/evm/signerEvm.ts:239

matchNetworkPreference

matchNetworkPreference(
preferences: NetworkPreference[],
currentNetwork: undefined | string,
): undefined | NetworkPreference
Parameters
- preferences: NetworkPreference[]
- currentNetwork: undefined | string
Returns undefined | NetworkPreference
Inherited from Signer.matchNetworkPreference
- Defined in signer/signer/index.ts:93

`Static`verifyMessage

verifyMessage(message: BytesLike, signature: Signature): Promise<boolean>
Parameters
- message: BytesLike
- signature: Signature
Returns Promise<boolean>
Inherited from Signer.verifyMessage
- Defined in signer/signer/index.ts:114

`Abstract`connect

connect(): Promise<void>
Connects to the signer.

Returns Promise<void>
A promise that resolves when the connection is complete.
Inherited from Signer.connect
- Defined in signer/signer/index.ts:165

onReplaced

onReplaced(_: () => void): () => void
Register a listener to be called when this signer is replaced.
Parameters
- _: () => void
Returns () => void
A function for unregister
Inherited from Signer.onReplaced
- Defined in signer/signer/index.ts:172

disconnect

disconnect(): Promise<void>
Disconnects to the signer.

Returns Promise<void>
A promise that resolves when the signer is disconnected.
Inherited from Signer.disconnect
- Defined in signer/signer/index.ts:181

`Abstract`isConnected

isConnected(): Promise<boolean>
Check if the signer is connected.

Returns Promise<boolean>
A promise that resolves the connection status.
Inherited from Signer.isConnected
- Defined in signer/signer/index.ts:188

getIdentity

getIdentity(): Promise<string>
Gets the identity for verifying signature, usually it's address

Returns Promise<string>
A promise that resolves to a string representing the identity
Inherited from Signer.getIdentity
- Defined in signer/signer/index.ts:202

getRecommendedAddressObj

getRecommendedAddressObj(_preference?: unknown): Promise<Address>
Gets the recommended Address object for the signer.
Parameters
- Optional_preference: unknown
  Optional preference parameter.
Returns Promise<Address>
A promise that resolves to the recommended Address object.
Inherited from Signer.getRecommendedAddressObj
- Defined in signer/signer/index.ts:219

getRecommendedAddress

getRecommendedAddress(preference?: unknown): Promise<string>
Gets the recommended address for the signer as a string.
Parameters
- Optionalpreference: unknown
  Optional preference parameter.
Returns Promise<string>
A promise that resolves to the recommended address as a string.
Inherited from Signer.getRecommendedAddress
- Defined in signer/signer/index.ts:229

getAddresses

getAddresses(): Promise<string[]>
Gets an array of addresses associated with the signer as strings.

Returns Promise<string[]>
A promise that resolves to an array of addresses as strings.
Inherited from Signer.getAddresses
- Defined in signer/signer/index.ts:238

findCellsOnChain

findCellsOnChain(
    filter: ClientIndexerSearchKeyFilterLike,
    withData?: null | boolean,
    order?: "asc" | "desc",
    limit?: number,
): AsyncGenerator<Cell>
Find cells of this signer
Parameters
- filter: ClientIndexerSearchKeyFilterLike
  The filter for the search key.
- OptionalwithData: null | boolean
  Whether to include cell data in the response.
- Optionalorder: "asc" | "desc"
  The order of the returned cells, can be "asc" or "desc".
- Optionallimit: number
  The maximum number of cells for every querying chunk.
Returns AsyncGenerator<Cell>
A async generator that yields all matching cells
Inherited from Signer.findCellsOnChain
- Defined in signer/signer/index.ts:253

findCells

findCells(
    filter: ClientCollectableSearchKeyFilterLike,
    withData?: null | boolean,
    order?: "asc" | "desc",
    limit?: number,
): AsyncGenerator<Cell>
Find cells of this signer
Parameters
- filter: ClientCollectableSearchKeyFilterLike
- OptionalwithData: null | boolean
- Optionalorder: "asc" | "desc"
- Optionallimit: number
Returns AsyncGenerator<Cell>
A async generator that yields all matches cells
Inherited from Signer.findCells
- Defined in signer/signer/index.ts:282

findTransactions

findTransactions(
    filter: ClientCollectableSearchKeyFilterLike,
    groupByTransaction?: null | false,
    order?: "asc" | "desc",
    limit?: number,
): AsyncGenerator<
    {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        isInput: boolean;
        cellIndex: bigint;
    },
>
Find transactions of this signer
Parameters
- filter: ClientCollectableSearchKeyFilterLike
- OptionalgroupByTransaction: null | false
- Optionalorder: "asc" | "desc"
- Optionallimit: number
Returns AsyncGenerator<
    {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        isInput: boolean;
        cellIndex: bigint;
    },
>
A async generator that yields all matches transactions
Inherited from Signer.findTransactions
- Defined in signer/signer/index.ts:311
findTransactions(
    filter: ClientCollectableSearchKeyFilterLike,
    groupByTransaction: true,
    order?: "asc" | "desc",
    limit?: number,
): AsyncGenerator<
    {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        cells: { isInput: boolean; cellIndex: bigint }[];
    },
>
Find transactions of this signer
Parameters
- filter: ClientCollectableSearchKeyFilterLike
- groupByTransaction: true
- Optionalorder: "asc" | "desc"
- Optionallimit: number
Returns AsyncGenerator<
    {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        cells: { isInput: boolean; cellIndex: bigint }[];
    },
>
A async generator that yields all matches transactions
Inherited from Signer.findTransactions
- Defined in signer/signer/index.ts:322
findTransactions(
    filter: ClientCollectableSearchKeyFilterLike,
    groupByTransaction?: null | boolean,
    order?: "asc" | "desc",
    limit?: number,
): AsyncGenerator<
    | {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        isInput: boolean;
        cellIndex: bigint;
    }
    | {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        cells: { isInput: boolean; cellIndex: bigint }[];
    },
>
Find transactions of this signer
Parameters
- filter: ClientCollectableSearchKeyFilterLike
- OptionalgroupByTransaction: null | boolean
- Optionalorder: "asc" | "desc"
- Optionallimit: number
Returns AsyncGenerator<
    | {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        isInput: boolean;
        cellIndex: bigint;
    }
    | {
        txHash: `0x${string}`;
        blockNumber: bigint;
        txIndex: bigint;
        cells: { isInput: boolean; cellIndex: bigint }[];
    },
>
A async generator that yields all matches transactions
Inherited from Signer.findTransactions
- Defined in signer/signer/index.ts:333

getBalance

getBalance(): Promise<bigint>
Gets balance of all addresses

Returns Promise<bigint>
A promise that resolves to the balance
Inherited from Signer.getBalance
- Defined in signer/signer/index.ts:379

signMessage

signMessage(message: BytesLike): Promise<Signature>
Signs a message.
Parameters
- message: BytesLike
  The message to sign, as a string or BytesLike object.
Returns Promise<Signature>
A promise that resolves to the signature info.

Throws
Will throw an error if not implemented.
Inherited from Signer.signMessage
- Defined in signer/signer/index.ts:392

signMessageRaw

signMessageRaw(_: BytesLike): Promise<string>
Signs a message and returns signature only. This method is not implemented and should be overridden by subclasses.
Parameters
- _: BytesLike
  The message to sign, as a string or BytesLike object.
Returns Promise<string>
A promise that resolves to the signature as a string.

Throws
Will throw an error if not implemented.
Inherited from Signer.signMessageRaw
- Defined in signer/signer/index.ts:407

verifyMessage

verifyMessage(
message: BytesLike,
signature: string | Signature,
): Promise<boolean>
Verify a signature.
Parameters
- message: BytesLike
  The original message.
- signature: string | Signature
  The signature to verify.
Returns Promise<boolean>
A promise that resolves to the verification result.

Throws
Will throw an error if not implemented.
Inherited from Signer.verifyMessage
- Defined in signer/signer/index.ts:419

sendTransaction

sendTransaction(tx: TransactionLike): Promise<`0x${string}`>
Sends a transaction after signing it.
Parameters
- tx: TransactionLike
  The transaction to send, represented as a TransactionLike object.
Returns Promise<`0x${string}`>
A promise that resolves to the transaction hash as a Hex string.
Inherited from Signer.sendTransaction
- Defined in signer/signer/index.ts:447

signTransaction

signTransaction(tx: TransactionLike): Promise<Transaction>
Signs a transaction.
Parameters
- tx: TransactionLike
  The transaction to sign, represented as a TransactionLike object.
Returns Promise<Transaction>
A promise that resolves to the signed Transaction object.
Inherited from Signer.signTransaction
- Defined in signer/signer/index.ts:457

Class SignerEvmAbstract

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns SignerEvm

Properties

Protectedclient_

Accessors

type

Returns SignerType

signType

Returns SignerSignType

client

Returns Client

Methods

AbstractgetEvmAccount

Returns Promise<`0x${string}`>

getInternalAddress

Returns Promise<string>

getAddressObjs

Returns Promise<Address[]>

_getOmniLockAddresses

Parameters

Returns Promise<Address[]>

_getPWLockAddresses

Parameters

Returns Promise<Address[]>

_getOmniLockEvmAddressObj

Parameters

Returns Promise<Address>

_getOmniLockOldEvmAddressObj

Parameters

Returns Promise<Address>

_getPWLockEvmAddressObj

Parameters

Returns Promise<undefined | Address>

prepareTransaction

Parameters

Returns Promise<Transaction>

signOnlyTransaction

Parameters

Returns Promise<Transaction>

_signOmniLockScriptForTransaction

Parameters

Returns Promise<Transaction>

_signPWLockScriptForTransaction

Parameters

Returns Promise<Transaction>

_signPersonalEvmForTransaction

Parameters

Returns Promise<undefined | { signature: Bytes; position: number }>

matchNetworkPreference

Parameters

Returns undefined | NetworkPreference

StaticverifyMessage

Parameters

Returns Promise<boolean>

Abstractconnect

Returns Promise<void>

onReplaced

Parameters

Returns () => void

disconnect

Returns Promise<void>

AbstractisConnected

Returns Promise<boolean>

getIdentity

Returns Promise<string>

getRecommendedAddressObj

Parameters

Returns Promise<Address>

getRecommendedAddress

Parameters

Returns Promise<string>

Class SignerEvm`Abstract`

`Protected`client_

`Abstract`getEvmAccount

`Static`verifyMessage

`Abstract`connect

`Abstract`isConnected

Returns AsyncGenerator<
{
txHash: `0x${string}`;
blockNumber: bigint;
txIndex: bigint;
isInput: boolean;
cellIndex: bigint;
},
>

Returns AsyncGenerator<
{
txHash: `0x${string}`;
blockNumber: bigint;
txIndex: bigint;
cells: { isInput: boolean; cellIndex: bigint }[];
},
>

Returns AsyncGenerator<
| {
txHash: `0x${string}`;
blockNumber: bigint;
txIndex: bigint;
isInput: boolean;
cellIndex: bigint;
}
| {
txHash: `0x${string}`;
blockNumber: bigint;
txIndex: bigint;
cells: { isInput: boolean; cellIndex: bigint }[];
},
>