@audius/eth

@audius/eth

Typed ABIs and production addresses for the Audius Ethereum contracts. Designed for use with viem and fully tree-shakable — import only the contracts you need.

Installation

npm install @audius/eth viem

Usage

Each contract export is a plain object with abi and address:

import { createPublicClient, http } from 'viem'
import { mainnet } from 'viem/chains'
import { Staking } from '@audius/eth'

const client = createPublicClient({
  chain: mainnet,
  transport: http()
})

const totalStaked = await client.readContract({
  ...Staking,
  functionName: 'totalStaked'
})

Check pending rewards claim

import { ClaimsManager } from '@audius/eth'

const isPending = await client.readContract({
  ...ClaimsManager,
  functionName: 'claimPending',
  args: ['0xYourServiceProviderAddress']
})

Read a governance proposal

import { Governance } from '@audius/eth'

const proposal = await client.readContract({
  ...Governance,
  functionName: 'getProposalById',
  args: [1n]
})

Look up service provider endpoints

import { ServiceProviderFactory, VALIDATOR_SERVICE_TYPE } from '@audius/eth'

// Get the total number of validators
const total = await client.readContract({
  ...ServiceProviderFactory,
  functionName: 'getTotalServiceTypeProviders',
  args: [VALIDATOR_SERVICE_TYPE]
})

// Get the endpoint info for the first one
const info = await client.readContract({
  ...ServiceProviderFactory,
  functionName: 'getServiceEndpointInfo',
  args: [VALIDATOR_SERVICE_TYPE, 1n]
})

EIP-2612 permit (gasless approval)

AudiusToken and AudiusWormhole include domain and types for EIP-712 signing:

import { AudiusToken } from '@audius/eth'

const signature = await walletClient.signTypedData({
  domain: {
    ...AudiusToken.domain,
    chainId: 1,
    verifyingContract: AudiusToken.address
  },
  types: AudiusToken.types,
  primaryType: 'Permit',
  message: {
    owner: '0x...',
    spender: '0x...',
    value: 1000000000000000000n,
    nonce: 0n,
    deadline: 99999999999n
  }
})

Contracts

Export	Description
AudiusToken	The AUDIO ERC-20 token. Mintable, pausable, burnable. Supports EIP-2612 permit().
AudiusWormhole	Sends AUDIO cross-chain via Wormhole with meta-transaction support.
ClaimsManager	Periodic minting and distribution of AUDIO staking rewards.
DelegateManager	Delegation of AUDIO tokens to service providers with lockup periods.
EthRewardsManager	Transfers AUDIO rewards from Ethereum to Solana via Wormhole.
Governance	On-chain governance: proposals, stake-weighted voting, execution.
Registry	Central directory mapping contract names to addresses.
ServiceProviderFactory	Registration and staking for discovery nodes and content nodes.
ServiceTypeManager	Registry of valid service types and their versions.
Staking	Core staking contract holding all staked AUDIO with checkpointing.
TrustedNotifierManager	Registry of trusted notifier entities.