README.md

eigensdk-js

A Javascript SDK for EigenLayer, derived from the official eigensdk-go implementation.

Caution

This library is a PoC implemented for the EigenLayer hackathon. Do not use it in Production, testnet only.

Example

You can use Incredible Squaring Javascript AVS as an example application using this SDK.

Test

Tests use the anvil chain snapshot of the Incredible Squaring AVS. To run tests, use the following commands after running the anvil chain as described here:

$ npm run test

Examples

Aggregate BLS signatures and verify using aggregated public key

import { KeyPair, G2Point, Signature } from './attestation';
import * as ethers from 'ethers';

function hashFunction(input: string): string {
	return ethers.keccak256(Buffer.from(input));
}

const textMessage = "sample text to sign"
const msgHash = hashFunction(textMessage)

const keyPair1 = new KeyPair()
const keyPair2 = KeyPair.fromString("04")

const sign1:Signature = keyPair1.signMessage(msgHash)
const sign2:Signature = keyPair2.signMessage(msgHash)

const aggregatedSignature:Signature = sign1.add(sign2);
const aggregatedPubG2:G2Point = keyPair1.pubG2.add(keyPair2.pubG2)

const verified = aggregatedSignature.verify(aggregatedPubG2, msgHash)

Example #2

Find the list of operators registered on EigenDA, a sample AVS:

import {BuildAllConfig, buildAll} from '../chainio/clients/builder'
import pino from 'pino'

async function run() {
	const config = new BuildAllConfig(
		'https://ethereum-rpc.publicnode.com',
		'0x0BAAc79acD45A023E19345c352d8a7a83C4e5656',
		'0xD5D7fB4647cE79740E6e83819EFDf43fa74F8C31'
	)

	const logger = pino({ level: 'info' });

	const clients = await buildAll(config, "01".padStart(64, '0'), logger)

	const quorums = await clients.avsRegistryReader.getOperatorsStakeInQuorumsAtCurrentBlock([0, 1])

	console.log(quorums)
}

run()
	.catch(e => console.log(e))
	.finally(() => process.exit(0))

Output:

[
  [
    {
      operator: '0x4Cd2...Bd0a',
      operatorId: '0x62fd...e8ee',
      stake: 46234599345769649597926n
    },
    {
      operator: '0xe580...fbFa',
      operatorId: '0x3a6f...f567',
      stake: 809492531621623334023n
    },
	...
  ],
  ...
]