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 full)

ccc.Signer
- SignerEvm
  - SignerEvmAddressReadonly

Constructors

constructor

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

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:86

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<ccc.Address[]>
Gets an array of Address objects representing the known script addresses for the signer.

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

_getOmniLockAddresses

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

_getPWLockAddresses

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

_getOmniLockEvmAddressObj

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

_getOmniLockOldEvmAddressObj

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

_getPWLockEvmAddressObj

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

prepareTransaction

prepareTransaction(txLike): 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): 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, script, messageTransformer): Promise<Transaction>
Parameters
- tx: Transaction
- script: Script
- messageTransformer: ((hash: string) => BytesLike)
  - - (hash): BytesLike
    - Parameters
      hash: string
      Returns BytesLike
Returns Promise<Transaction>
- Defined in signer/evm/signerEvm.ts:186

_signPWLockScriptForTransaction

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

_signPersonalEvmForTransaction

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

matchNetworkPreference

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

`Static`verifyMessage

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

`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:163

onReplaced

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

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:179

`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:186

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:200

getRecommendedAddressObj

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

getRecommendedAddress

getRecommendedAddress(preference?): 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:227

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:236

findCells

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

findTransactions

findTransactions(filter, groupByTransaction?, order?, limit?): AsyncGenerator<{
    txHash: `0x${string}`;
    blockNumber: bigint;
    txIndex: bigint;
    isInput: boolean;
    cellIndex: bigint;
}, any, unknown>
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;
}, any, unknown>
A async generator that yields all matches transactions
Inherited from Signer.findTransactions
- Defined in signer/signer/index.ts:276
findTransactions(filter, groupByTransaction, order?, limit?): AsyncGenerator<{
    txHash: `0x${string}`;
    blockNumber: bigint;
    txIndex: bigint;
    cells: {
        isInput: boolean;
        cellIndex: bigint;
    }[];
}, any, unknown>
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;
    }[];
}, any, unknown>
A async generator that yields all matches transactions
Inherited from Signer.findTransactions
- Defined in signer/signer/index.ts:287
findTransactions(filter, groupByTransaction?, order?, limit?): AsyncGenerator<{
    txHash: `0x${string}`;
    blockNumber: bigint;
    txIndex: bigint;
    isInput: boolean;
    cellIndex: bigint;
} | {
    txHash: `0x${string}`;
    blockNumber: bigint;
    txIndex: bigint;
    cells: {
        isInput: boolean;
        cellIndex: bigint;
    }[];
}, any, unknown>
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;
    }[];
}, any, unknown>
A async generator that yields all matches transactions
Inherited from Signer.findTransactions
- Defined in signer/signer/index.ts:298

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:344

signMessage

signMessage(message): 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:357

signMessageRaw

signMessageRaw(_): 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:372

verifyMessage

verifyMessage(message, 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:384

sendTransaction

sendTransaction(tx): 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:412

signTransaction

signTransaction(tx): 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:422

Class SignerEvmAbstract

Hierarchy (view full)

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<ccc.Address[]>

_getOmniLockAddresses

Parameters

Returns Promise<ccc.Address[]>

_getPWLockAddresses

Parameters

Returns Promise<ccc.Address[]>

_getOmniLockEvmAddressObj

Parameters

Returns Promise<ccc.Address>

_getOmniLockOldEvmAddressObj

Parameters

Returns Promise<ccc.Address>

_getPWLockEvmAddressObj

Parameters

Returns Promise<undefined | ccc.Address>

prepareTransaction

Parameters

Returns Promise<Transaction>

signOnlyTransaction

Parameters

Returns Promise<Transaction>

_signOmniLockScriptForTransaction

Parameters

Parameters

Returns BytesLike

Returns Promise<Transaction>

_signPWLockScriptForTransaction

Parameters

Parameters

Returns BytesLike

Returns Promise<Transaction>

_signPersonalEvmForTransaction

Parameters

Parameters

Returns BytesLike

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

matchNetworkPreference

Parameters

Returns undefined | NetworkPreference

StaticverifyMessage

Parameters

Returns Promise<boolean>

Abstractconnect

Returns Promise<void>

onReplaced

Parameters

Returns void

Returns (() => void)

Returns void

disconnect

Returns Promise<void>

AbstractisConnected

Returns Promise<boolean>

Class SignerEvm`Abstract`

`Protected`client_

`Abstract`getEvmAccount

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

`Static`verifyMessage

`Abstract`connect

`Abstract`isConnected

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

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

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;
}[];
}, any, unknown>