Class: EthSigner

Signer for accounts using Ethereum signature

Implements

• SignerInterface

Constructors

constructor

• new EthSigner(pk?): EthSigner

Parameters

Name	Type
pk	string | Uint8Array

Returns

EthSigner

Defined in

src/signer/ethSigner.ts:42

Properties

pk

• Protected pk: string

Defined in

src/signer/ethSigner.ts:40

Methods

getPubKey

▸ getPubKey(): Promise<string>

provides the Ethereum full public key (without parity prefix)

Returns

Promise<string>

an hex string : 64 first characters are Point X coordinate. 64 last characters are Point Y coordinate.

Implementation of

SignerInterface.getPubKey

Defined in

src/signer/ethSigner.ts:53

---

signMessage

▸ signMessage(typedData, accountAddress): Promise<Signature>

Signs a JSON object for off-chain usage with the private key and returns the signature. This adds a message prefix so it can't be interchanged with transactions

Parameters

Name	Type	Description
typedData	TypedData	JSON object to be signed
accountAddress	string	Hex string of the account's address

Returns

Promise<Signature>

the signature of the message

Example

const mySigner = new Signer('0x123');
const myTypedData: TypedData = {
  domain: { name: 'Example DApp', chainId: constants.StarknetChainId.SN_SEPOLIA, version: '0.0.3' },
  types: {
    StarkNetDomain: [
      { name: 'name', type: 'string' },
      { name: 'chainId', type: 'felt' },
      { name: 'version', type: 'string' },
    ],
    Message: [{ name: 'message', type: 'felt' }],
  },
  primaryType: 'Message',
  message: { message: '1234' },
};
const result = await mySigner.signMessage(
  myTypedData,
  '0x5d08a4e9188429da4e993c9bf25aafe5cd491ee2b501505d4d059f0c938f82d'
);
// result = Signature {r: 684915484701699003335398790608214855489903651271362390249153620883122231253n,
// s: 1399150959912500412309102776989465580949387575375484933432871778355496929189n, recovery: 1}

Implementation of

SignerInterface.signMessage

Defined in

src/signer/ethSigner.ts:59

---

signTransaction

▸ signTransaction(transactions, details): Promise<Signature>

Signs transactions with the private key and returns the signature

Parameters

Name	Type	Description
transactions	Call[]	array of Call objects
details	InvocationsSignerDetails	InvocationsSignerDetails object

Returns

Promise<Signature>

the signature of the transaction

Example

const mySigner = new Signer('0x123');
const calls: Call[] = [
  {
    contractAddress: '0x1234567890123456789012345678901234567890',
    entrypoint: 'functionName',
    calldata: [1, 2, 3],
  },
];
const transactionsDetail: InvocationsSignerDetails = {
  walletAddress: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
  chainId: constants.StarknetChainId.SN_MAIN,
  cairoVersion: '1',
  maxFee: '0x1234567890abcdef',
  version: '0x0',
  nonce: 1,
};
const result = await mySigner.signTransaction(calls, transactionsDetail);
// result = Signature {r: 304910226421970384958146916800275294114105560641204815169249090836676768876n,
//   s: 1072798866000813654190523783606274062837012608648308896325315895472901074693n, recovery: 0}

Implementation of

SignerInterface.signTransaction

Defined in

src/signer/ethSigner.ts:68

---

signDeployAccountTransaction

▸ signDeployAccountTransaction(details): Promise<Signature>

Signs a DEPLOY_ACCOUNT transaction with the private key and returns the signature

Parameters

Name	Type	Description
details	DeployAccountSignerDetails	to deploy an account contract

Returns

Promise<Signature>

the signature of the transaction to deploy an account

Example

const mySigner = new Signer('0x123');
const myDeployAcc: DeployAccountSignerDetails = {
  contractAddress: '0x65a822fbee1ae79e898688b5a4282dc79e0042cbed12f6169937fddb4c26641',
  version: '0x2',
  chainId: constants.StarknetChainId.SN_SEPOLIA,
  classHash: '0x5f3614e8671257aff9ac38e929c74d65b02d460ae966cd826c9f04a7fa8e0d4',
  constructorCalldata: [1, 2],
  addressSalt: 1234,
  nonce: 45,
  maxFee: 10 ** 15,
  tip: 0,
  paymasterData: [],
  accountDeploymentData: [],
  nonceDataAvailabilityMode: RPC.EDataAvailabilityMode.L1,
  feeDataAvailabilityMode: RPC.EDataAvailabilityMode.L1,
  resourceBounds: stark.estimateFeeToBounds(constants.ZERO),
};
const result = await mySigner.signDeployAccountTransaction(myDeployAcc);
// result = Signature {r: 2871311234341436528393212130310036951068553852419934781736214693308640202748n,
//  s: 1746271646048888422437132495446973163454853863041370993384284773665861377605n, recovery: 1}

Implementation of

SignerInterface.signDeployAccountTransaction

Defined in

src/signer/ethSigner.ts:104

---

signDeclareTransaction

▸ signDeclareTransaction(details): Promise<Signature>

Signs a DECLARE transaction with the private key and returns the signature

Parameters

Name	Type	Description
details	DeclareSignerDetails	to declare a class

Returns

Promise<Signature>

the signature of the transaction to declare a class

Example

const mySigner = new Signer('0x123');
const myDeclare: DeclareSignerDetails = {
  version: '0x2',
  chainId: constants.StarknetChainId.SN_SEPOLIA,
  senderAddress: '0x65a822fbee1ae79e898688b5a4282dc79e0042cbed12f6169937fddb4c26641',
  classHash: '0x5f3614e8671257aff9ac38e929c74d65b02d460ae966cd826c9f04a7fa8e0d4',
  nonce: 45,
  maxFee: 10 ** 15,
  tip: 0,
  paymasterData: [],
  accountDeploymentData: [],
  nonceDataAvailabilityMode: RPC.EDataAvailabilityMode.L1,
  feeDataAvailabilityMode: RPC.EDataAvailabilityMode.L1,
  resourceBounds: stark.estimateFeeToBounds(constants.ZERO),
};
const result = await mySigner.signDeclareTransaction(myDeclare);
// result = Signature {r: 2432056944313955951711774394836075930010416436707488863728289188289211995670n,
//  s: 3407649393310177489888603098175002856596469926897298636282244411990343146307n, recovery: 1}

Implementation of

SignerInterface.signDeclareTransaction

Defined in

src/signer/ethSigner.ts:139

---

formatEthSignature

▸ formatEthSignature(ethSignature): ArraySignatureType

Serialize the signature in conformity with starknet::eth_signature::Signature

Parameters

Name	Type	Description
ethSignature	RecoveredSignatureType	secp256k1 signature from Noble curves library

Returns

ArraySignatureType

an array of felts, representing a Cairo Eth Signature.

Defined in

src/signer/ethSigner.ts:175