https://github.com/base/eip712sign
Golang utility for signing EIP-712 payloads
https://github.com/base/eip712sign
Last synced: 6 months ago
JSON representation
Golang utility for signing EIP-712 payloads
- Host: GitHub
- URL: https://github.com/base/eip712sign
- Owner: base
- License: mit
- Created: 2023-07-20T06:50:16.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-10-20T22:18:20.000Z (8 months ago)
- Last Synced: 2025-10-22T00:35:42.218Z (8 months ago)
- Language: Go
- Homepage:
- Size: 85.9 KB
- Stars: 98
- Watchers: 14
- Forks: 59
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# eip712sign
Small golang utility used to sign EIP-712 typed data or hashes, and EIP-191 personal messages. Supports:
- ledgers
- trezors
- mnemonics
- raw private keys
[](https://github.com/base/eip712sign/graphs/contributors)
[](https://github.com/base/eip712sign/graphs/contributors)
[](https://github.com/base/eip712sign/stargazers)
[](https://github.com/base/eip712sign/blob/main/LICENSE)
[](https://base.org)
[](https://base.mirror.xyz/)
[](https://docs.base.org/)
[](https://base.org/discord)
[](https://twitter.com/BuildOnBase)
[](https://github.com/base/eip712sign/pulls)
[](https://github.com/base/eip712sign/issues)
### Installation
```shell
go install github.com/base/eip712sign
```
### Flags
```shell
Usage of eip712sign:
-address
Print address of signer and exit
-data string
Data to be signed
-hd-paths string
Hierarchical deterministic derivation path for mnemonic, ledger, or trezor (default "m/44'/60'/0'/0/0")
-index int
Device index to use (if multiple devices are connected)
-ledger
Use ledger device for signing
-mnemonic string
Mnemonic to use for signing
-prefix string
String that prefixes the data to be signed (default "vvvvvvvv")
-private-key string
Private key to use for signing
-skip-sender
Skip adding the --sender flag to forge script commands
-suffix string
String that suffixes the data to be signed (default "^^^^^^^^")
-text
Use EIP-191 message format for signing (default is EIP-712)
-trezor
Use trezor device for signing
-workdir string
Directory in which to run the subprocess (default ".")
```
### Usage
`eip712sign` can either be run as a command wrapper, or data can be piped in via stdin.
The former is recommended as it will only attempt to sign if the subprocess exit code is 0.
```shell
eip712sign --ledger --
```
or
```shell
| eip712sign --ledger
```
Example signing some bytes output from a forge script:
```shell
eip712sign --ledger -- forge script --rpc-url SomeScript
```
`eip712sign` will parse the stdout from the subprocess, and by default, sign any hex string between the magic strings `vvvvvvvv` and `^^^^^^^^`.
This prefix + suffix can be configured using the `-prefix` and `-suffix` flags.
In this example, `SomeScript` should print this to the console, for example:
```solidity
function printDataToSign(bytes memory data) internal pure {
console.log("vvvvvvvv");
console.logBytes(data);
console.log("^^^^^^^^");
}
```
...where `data` is 66 bytes in length for EIP-712 hashes, or JSON for EIP-712 typed data (can optionally be hex encoded).
Example output:
```shell
Compiling 5 files with 0.8.15
Solc 0.8.15 finished in 7.01s
Compiler run successful!
Script ran successfully.
== Logs ==
vvvvvvvv
0x19011b6ca1022dcb8ee88e2ab8dd1adf6f6bfa6af586f8b074e99c952e6e3c6befadd5c5183a56f8aa2520c9522029fc20aba61ce6c6aa32aec3b00519c95eb819e8
^^^^^^^^
forge exited with code 0
Domain hash: 0x1b6ca1022dcb8ee88e2ab8dd1adf6f6bfa6af586f8b074e99c952e6e3c6befad
Message hash: 0xd5c5183a56f8aa2520c9522029fc20aba61ce6c6aa32aec3b00519c95eb819e8
Data: 0x19011b6ca1022dcb8ee88e2ab8dd1adf6f6bfa6af586f8b074e99c952e6e3c6befadd5c5183a56f8aa2520c9522029fc20aba61ce6c6aa32aec3b00519c95eb819e8
Signer: 0x4A02DE0C8a1C74AB99D1eCeb56d1d5f54B8293b0
Signature: 36b6a15e3e86b1ae44bdfc9183c4d86b0eaead44c838530ecb2e43dd0618559579195d42fe63868a44ee0279feef0181b1a9ed3b0faa89bf1ebd48b0f48f54bc1c
```