feat(precompiles): sync ABIs with Sei Chain v6.6.1 (#330)

* feat(precompiles): sync ABIs with Sei Chain v6.6.1 (PLT-996)

Expose the full live precompile surface, including P256 and missing staking/query APIs, while pinning ABI parity to the frozen v6.6 snapshot.

* docs(precompiles): clarify ABI release support

Distinguish frozen chain snapshots from the current surface and link the live-chain reasons for excluding Oracle and IBC.

* fix(precompiles): harden v6.6 ABI verification

Compare against independently vendored chain fixtures and document P256 packing and failure semantics so consumers cannot mistake invalid signatures for success.

* Remove viem ABI aliases and adjust exports

Remove the viem-specific VIEM_* ABI aliases and related viem/*Precompile files; export raw as-const ABIs from the package root (and viem entrypoint) instead. Add `satisfies Abi` typing to raw ABI exports, update the public examples/templates to use BANK_PRECOMPILE_ABI, adjust tests and the export barrel (root now re-exports viem/chain), and update scripts and README. Breaking: VIEM_* ABI aliases were removed — import the raw *_PRECOMPILE_ABI constants (they work directly with Viem).

Author: alexander-sei

.changeset/remove-ibc-oracle-precompiles.md

@@ -2,6 +2,8 @@
 '@sei-js/precompiles': major
 ---
 
-**Breaking:** remove the IBC and Oracle precompiles. `IBC_PRECOMPILE_ADDRESS`, `IBC_PRECOMPILE_ABI`, `ETHERS_IBC_PRECOMPILE_ABI`, `getIbcPrecompileEthersV6Contract`, `VIEM_IBC_PRECOMPILE_ABI`, `ORACLE_PRECOMPILE_ADDRESS`, `ORACLE_PRECOMPILE_ABI`, `ETHERS_ORACLE_PRECOMPILE_ABI`, `getOraclePrecompileEthersV6Contract`, and `VIEM_ORACLE_PRECOMPILE_ABI` are no longer exported.
+**Breaking:** remove the unsupported IBC and Oracle precompile addresses, ABIs, and Ethers factories.
 
 Neither precompile is supported on Sei any more, so calls to them fail on-chain regardless of where the address and ABI come from. There is no drop-in replacement: re-declaring them locally will not restore working calls, and code still depending on them needs to move off these precompiles.
+
+Also remove the redundant Viem-specific ABI aliases. Import the raw `*_PRECOMPILE_ABI` constants instead; they work directly with Viem and preserve literal types for contract inference. The `viem` subpath re-exports these raw constants alongside the Sei chain definitions.

.changeset/sync-v66-precompiles.md

@@ -0,0 +1,7 @@
+---
+'@sei-js/precompiles': minor
+---
+
+Sync the exported precompile ABIs with Sei Chain v6.6.1.
+
+This adds the P256 precompile address, ABI, and Ethers factory. It also adds the missing staking queries and events, governance proposal methods, distribution events and validator commission withdrawal, JSON array extraction, and CW1155 pointer methods.

biome.json

@@ -15,6 +15,7 @@
 			"!**/bun.lock",
 			"!packages/create-sei/templates",
 			"!packages/create-sei/extensions",
+			"!packages/precompiles/src/__tests__/fixtures/v66",
 			"!packages/registry/chain-registry",
 			"!packages/registry/community-assetlist"
 		]

packages/create-sei/extensions/precompiles/src/components/default/index.tsx

@@ -3,10 +3,9 @@
 import { CodeHighlight } from '@mantine/code-highlight';
 import { ActionIcon, Badge, Button, Card, Collapse, Container, Flex, Group, Paper, Stack, Text, ThemeIcon, Title } from '@mantine/core';
 import { notifications } from '@mantine/notifications';
-import { BANK_PRECOMPILE_ADDRESS, VIEM_BANK_PRECOMPILE_ABI } from '@sei-js/precompiles';
+import { BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';
 import { IconBulb, IconChevronDown, IconChevronUp, IconCopy, IconDatabase } from '@tabler/icons-react';
 import { useState } from 'react';
-import type { ReadContractParameters } from 'viem';
 import { usePublicClient } from 'wagmi';
 
 function Examples() {
@@ -49,16 +48,14 @@ function Examples() {
 			return undefined;
 		}
 
-		const readContractParams: ReadContractParameters = {
-			abi: VIEM_BANK_PRECOMPILE_ABI,
-			address: BANK_PRECOMPILE_ADDRESS,
-			functionName: 'supply',
-			args: ['usei']
-		};
-
 		try {
-			const result = await publicClient.readContract(readContractParams);
-			setSupply((result as bigint).toString());
+			const result = await publicClient.readContract({
+				abi: BANK_PRECOMPILE_ABI,
+				address: BANK_PRECOMPILE_ADDRESS,
+				functionName: 'supply',
+				args: ['usei']
+			});
+			setSupply(result.toString());
 		} catch (error) {
 			console.error('Error fetching supply:', error);
 			notifications.show({
@@ -70,21 +67,19 @@ function Examples() {
 	};
 
 	const codeExample = `// Sei Precompile Example - Bank Precompile
-import { BANK_PRECOMPILE_ADDRESS, VIEM_BANK_PRECOMPILE_ABI } from '@sei-js/precompiles';
+import { BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';
 import { usePublicClient } from 'wagmi';
 
 const publicClient = usePublicClient();
 
 const getSeiSupply = async () => {
-  const readContractParams = {
-    abi: VIEM_BANK_PRECOMPILE_ABI,
+  const result = await publicClient?.readContract({
+    abi: BANK_PRECOMPILE_ABI,
     address: BANK_PRECOMPILE_ADDRESS,
     functionName: 'supply',
     args: ['usei'],
-  };
-
-  const result = await publicClient?.readContract(readContractParams);
-  return (result as bigint).toString();
+  });
+  return result?.toString();
 };`;
 
 	return (

packages/create-sei/templates/next-template/src/components/default/examples.ts

@@ -26,22 +26,19 @@ const weiBalance = await publicClient.getBalance({ address });
 const seiBalance = formatEther(weiBalance);`;
 
 export const precompileCodeExample = `// Import Sei precompiles
-import { VIEM_BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';
+import { BANK_PRECOMPILE_ABI, BANK_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';
 import { usePublicClient } from 'wagmi';
-import { type ReadContractParameters } from 'viem';
 
 // Use the hook
 const publicClient = usePublicClient();
 
 // Call precompile
-const readContractParams: ReadContractParameters = {
-  abi: VIEM_BANK_PRECOMPILE_ABI,
+const result = await publicClient.readContract({
+  abi: BANK_PRECOMPILE_ABI,
   address: BANK_PRECOMPILE_ADDRESS,
   functionName: 'supply',
   args: ['usei']
-};
-
-const result = await publicClient.readContract(readContractParams);`;
+});`;
 
 export const transactionCodeExample = `// Import transaction hooks
 import { useSendTransaction, useWaitForTransactionReceipt } from 'wagmi';

packages/precompiles/README.md

@@ -7,23 +7,59 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Sei Network](https://img.shields.io/badge/Sei-Network-red)](https://sei.io)
 
-**TypeScript utilities for interacting with Sei's precompile contracts**
+TypeScript ABIs, addresses, and Ethers/Viem helpers for Sei precompiles.
 
 [GitHub](https://github.com/sei-protocol/sei-js) • [NPM](https://www.npmjs.com/package/@sei-js/precompiles) • [Telegram](https://t.me/+LPW_1djQwRQwMzlk)
 
 </div>
 
-## 🚀 Quick Start
+## Install
 
 ```bash
 npm install @sei-js/precompiles
 ```
 
-Works seamlessly with your favorite Ethereum development tools:
-- **Viem** - Type-safe contract interactions
-- **Ethers.js** - Contract factories and utilities
-- **Wagmi** - React hooks for precompile contracts
-- **Hardhat/Foundry** - Testing and deployment
+## Sei Chain compatibility
+
+The exported ABIs match [Sei Chain v6.6.1](https://github.com/sei-protocol/sei-chain/tree/v6.6.1/precompiles). The `legacy/v66` directory is a frozen historical snapshot for that release, not a moving view of the current chain surface. Chain and package versions are independent; adopting a later Sei Chain minor snapshot is treated as at least a minor release of `@sei-js/precompiles`.
+
+This package exports:
+
+- Bank at `0x0000000000000000000000000000000000001001`
+- CosmWasm at `0x0000000000000000000000000000000000001002`
+- JSON at `0x0000000000000000000000000000000000001003`
+- Address association at `0x0000000000000000000000000000000000001004`
+- Staking at `0x0000000000000000000000000000000000001005`
+- Governance at `0x0000000000000000000000000000000000001006`
+- Distribution at `0x0000000000000000000000000000000000001007`
+- Pointer view at `0x000000000000000000000000000000000000100A`
+- Pointer registration at `0x000000000000000000000000000000000000100B`
+- Solo migration at `0x000000000000000000000000000000000000100C`
+- P256 verification at `0x0000000000000000000000000000000000001011`
+
+Oracle and IBC are intentionally excluded: the [v6.6.1 Oracle implementation returns a retired error for every query](https://github.com/sei-protocol/sei-chain/blob/v6.6.1/precompiles/oracle/oracle.go#L85-L104), and [SIP-03 disabled IBC in both directions](https://docs.sei.io/learn/sip-03-migration#ibc-is-disabled). Calls to either cannot succeed on live Sei. Some ABI methods can also be disabled by chain governance. Check the [Sei precompile docs](https://docs.sei.io/evm/precompiles/example-usage) before using a deprecated module or method.
+
+## Usage
+
+Addresses and raw `as const` ABIs are available from the package root and the `precompiles` and `viem` entrypoints. They work directly with Viem and preserve full type inference. Ethers factories are available from the `ethers` entrypoint.
+
+```ts
+import { STAKING_PRECOMPILE_ABI, STAKING_PRECOMPILE_ADDRESS } from '@sei-js/precompiles';
+import { getStakingPrecompileEthersV6Contract } from '@sei-js/precompiles/ethers';
+```
+
+With a configured Viem public client, the v6.6 staking query methods can be called directly:
+
+```ts
+const result = await publicClient.readContract({
+	address: STAKING_PRECOMPILE_ADDRESS,
+	abi: STAKING_PRECOMPILE_ABI,
+	functionName: 'validators',
+	args: ['BOND_STATUS_BONDED', '0x']
+});
+
+console.log(result.validators, result.nextKey);
+```
 
 ## Sei chain definitions
 

packages/precompiles/src/__tests__/barrelParity.spec.ts

@@ -2,7 +2,7 @@ import * as ethersBarrel from '../ethers';
 import * as precompilesBarrel from '../precompiles';
 import * as viemBarrel from '../viem';
 
-const precompileNamesFrom = (barrel: Record<string, unknown>, prefix: '' | 'ETHERS_' | 'VIEM_'): string[] => {
+const precompileNamesFrom = (barrel: Record<string, unknown>, prefix: '' | 'ETHERS_'): string[] => {
 	const pattern = new RegExp(`^${prefix}([A-Z0-9]+)_PRECOMPILE_ABI$`);
 
 	return Object.keys(barrel)
@@ -14,7 +14,7 @@ const precompileNamesFrom = (barrel: Record<string, unknown>, prefix: '' | 'ETHE
 describe('Precompile barrel parity', () => {
 	const precompileNames = precompileNamesFrom(precompilesBarrel, '');
 	const ethersNames = precompileNamesFrom(ethersBarrel, 'ETHERS_');
-	const viemNames = precompileNamesFrom(viemBarrel, 'VIEM_');
+	const viemNames = precompileNamesFrom(viemBarrel, '');
 
 	// Without this the three comparisons below would pass on three empty sets if the
 	// ABI naming convention ever changes out from under the pattern above.

packages/precompiles/src/__tests__/fixtures/v66/README.md

@@ -0,0 +1,5 @@
+# Sei Chain v6.6 ABI fixtures
+
+The JSON files in this directory are verbatim copies of `precompiles/*/legacy/v66/abi.json` from the [`v6.6.1`](https://github.com/sei-protocol/sei-chain/tree/v6.6.1/precompiles) tag of `sei-chain`.
+
+The parity test compares the package's TypeScript ABI constants with these independently vendored fixtures. IBC and Oracle are retained here to document the complete frozen snapshot, but they are intentionally not exported by `@sei-js/precompiles`.

packages/precompiles/src/__tests__/fixtures/v66/addr.json

@@ -0,0 +1 @@
+[{"inputs":[{"internalType":"string","name":"v","type":"string"},{"internalType":"string","name":"r","type":"string"},{"internalType":"string","name":"s","type":"string"},{"internalType":"string","name":"customMessage","type":"string"}],"name":"associate","outputs":[{"internalType":"string","name":"seiAddr","type":"string"},{"internalType":"address","name":"evmAddr","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"pubKeyHex","type":"string"}],"name":"associatePubKey","outputs":[{"internalType":"string","name":"seiAddr","type":"string"},{"internalType":"address","name":"evmAddr","type":"address"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"addr","type":"address"}],"name":"getSeiAddr","outputs":[{"internalType":"string","name":"response","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"addr","type":"string"}],"name":"getEvmAddr","outputs":[{"internalType":"address","name":"response","type":"address"}],"stateMutability":"view","type":"function"}]

packages/precompiles/src/__tests__/fixtures/v66/bank.json

@@ -0,0 +1 @@
+[{"inputs":[{"internalType":"address","name":"acc","type":"address"}],"name":"all_balances","outputs":[{"components":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"string","name":"denom","type":"string"}],"internalType":"struct IBank.Coin[]","name":"response","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"acc","type":"address"},{"internalType":"string","name":"denom","type":"string"}],"name":"balance","outputs":[{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"denom","type":"string"}],"name":"decimals","outputs":[{"internalType":"uint8","name":"response","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"denom","type":"string"}],"name":"name","outputs":[{"internalType":"string","name":"response","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"fromAddress","type":"address"},{"internalType":"address","name":"toAddress","type":"address"},{"internalType":"string","name":"denom","type":"string"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"send","outputs":[{"internalType":"bool","name":"success","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"toNativeAddress","type":"string"}],"name":"sendNative","outputs":[{"internalType":"bool","name":"success","type":"bool"}],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string","name":"denom","type":"string"}],"name":"supply","outputs":[{"internalType":"uint256","name":"response","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"denom","type":"string"}],"name":"symbol","outputs":[{"internalType":"string","name":"response","type":"string"}],"stateMutability":"view","type":"function"}]