The trusted fee approval & signing surface for GenLayer transactions — review the fee policy, hold to sign, follow consensus to an honest outcome. Works with any EIP-1193 wallet (mobile and non-MetaMask included); the GenLayer Snap is an optional verification layer, never a requirement.
| Package | What it is |
|---|---|
@genlayer/transaction-kit |
Framework-agnostic core: estimate → PolicyQuote, submit (direct route via the injected wallet), track to decided/finalized, verification fee-config hash. Built on genlayer-js v2. |
@genlayer/transaction-kit-react |
<GenLayerTransactionPanel /> + headless useTransactionFlow |
@genlayer/transaction-kit-vue |
Vue 3 equivalents |
Styling follows the GenLayer design system
(Space Grotesk / Switzer / JetBrains Mono, light-first with a dark theme), scoped under
gltk-* and themable via --gltk-* CSS variables.
Stage-1 scope: direct submission only. EIP-712 intents, the gateway contract and
ERC-7730 clear-signing metadata are stage 2 (see the wallet architecture doc in
genlayer-wallet).
npm github: dependencies can't reach monorepo subpackages, so each package is also
published as a packed orphan branch (npm pack output, dist included):
These branches are refreshed manually on release-worthy changes and go away once the packages are on npm.
import { createTransactionKit } from '@genlayer/transaction-kit';
import { GenLayerTransactionPanel } from '@genlayer/transaction-kit-react';
import '@genlayer/transaction-kit-react/styles.css';
import { testnetAsimov } from 'genlayer-js/chains';
const kit = createTransactionKit({ chain: testnetAsimov, provider: window.ethereum });
<GenLayerTransactionPanel
kit={kit}
tx={{ kind: 'write', address: contract, method: 'place_bet', args: [42] }}
network="testnet-asimov"
onDone={(status) => console.log(status)}
/>;The adapters never import the core at runtime — the kit instance is injected and typed structurally, so the packages version independently.
The kit depends only on an injected EIP-1193
provider — it never touches window.ethereum directly, so any wallet that exposes the
standard request() interface works, including embedded wallets. With Privy:
import { usePrivy, useWallets } from '@privy-io/react-auth';
const { wallets } = useWallets();
const wallet = wallets[0];
const provider = await wallet.getEthereumProvider(); // EIP-1193
const kit = createTransactionKit({
chain,
provider,
account: wallet.address as `0x${string}`,
});The provider must be on the GenLayer chain (use Privy's wallet.switchChain(chainId)
first). The GenLayer Snap verification badge is a MetaMask-only optional layer — with
any other wallet the panel simply shows the policy fingerprint instead.
The panel never simulates the call to size a quote — that's too expensive to run per
estimate. Instead, allocations come from a developer fee profile measured offline by
the contract's test suite (gltest --fee-profile fee-profile.json), with prices and
caps always read live:
import profile from './fee-profile.json';
const kit = createTransactionKit({
chain,
provider: window.ethereum,
suggestions: profile, // { deploy?, methods: { place_bet: {...} } }
});Merge order per estimate: preset (appeal posture) < suggestion (measured allocations)
< caller overrides. PolicyQuote.source reports 'developer' or 'network-default',
and the receipt shows the provenance. Profile values are decimal strings, so the JSON
artifact passes through unchanged; methods without an entry fall back to network
defaults.
{ "dependencies": { "@genlayer/transaction-kit": "github:genlayerlabs/genlayer-transaction-kit#pkg/core", "@genlayer/transaction-kit-react": "github:genlayerlabs/genlayer-transaction-kit#pkg/react", "@genlayer/transaction-kit-vue": "github:genlayerlabs/genlayer-transaction-kit#pkg/vue" } }