ox
Version:
180 lines • 5.95 kB
JavaScript
import * as AbiParameters from '../core/AbiParameters.js';
import * as Authorization from '../core/Authorization.js';
import * as Errors from '../core/Errors.js';
import * as Hex from '../core/Hex.js';
import * as Secp256k1 from '../core/Secp256k1.js';
import * as Signature from '../core/Signature.js';
/**
* Magic bytes used to identify ERC-8010 wrapped signatures.
*/
export const magicBytes = '0x8010801080108010801080108010801080108010801080108010801080108010';
/** Suffix ABI parameters for the ERC-8010 wrapped signature. */
export const suffixParameters = AbiParameters.from('(uint256 chainId, address delegation, uint256 nonce, uint8 yParity, uint256 r, uint256 s), address to, bytes data');
/**
* Asserts that the wrapped signature is valid.
*
* @example
* ```ts twoslash
* import { SignatureErc8010 } from 'ox/erc8010'
*
* SignatureErc8010.assert('0xdeadbeef')
* // @error: InvalidWrappedSignatureError: Value `0xdeadbeef` is an invalid ERC-8010 wrapped signature.
* ```
*
* @param value - The value to assert.
*/
export function assert(value) {
if (typeof value === 'string') {
if (Hex.slice(value, -32) !== magicBytes)
throw new InvalidWrappedSignatureError(value);
}
else
Signature.assert(value.authorization);
}
/**
* Parses an [ERC-8010 wrapped signature](https://github.com/jxom/ERCs/blob/16f7e3891fff2e1e9c25dea0485497739db8a816/ERCS/erc-8010.md) into its constituent parts.
*
* @example
* ```ts twoslash
* // @noErrors
* import { Secp256k1 } from 'ox'
* import { SignatureErc8010 } from 'ox/erc8010' // [!code focus]
*
* const signature = Secp256k1.sign({
* payload: '0x...',
* privateKey: '0x...',
* })
*
* // Instantiate from serialized format. // [!code focus]
* const wrapped = SignatureErc8010.from('0x...') // [!code focus]
* // @log: { authorization: { ... }, data: '0x...', signature: { ... } } // [!code focus]
*
* // Instantiate from constituent parts. // [!code focus]
* const wrapped = SignatureErc8010.from({ // [!code focus]
* authorization: { ... }, // [!code focus]
* data: '0x...', // [!code focus]
* signature, // [!code focus]
* })
* // @log: { authorization: { ... }, data: '0x...', signature: { ... } }
* ```
*
* @param value - Value to parse.
* @returns Parsed value.
*/
export function from(value) {
if (typeof value === 'string')
return unwrap(value);
return value;
}
/**
* Unwraps an [ERC-8010 wrapped signature](https://github.com/jxom/ERCs/blob/16f7e3891fff2e1e9c25dea0485497739db8a816/ERCS/erc-8010.md) into its constituent parts.
*
* @example
* ```ts twoslash
* import { SignatureErc8010 } from 'ox/erc8010'
*
* const { authorization, data, signature } = SignatureErc8010.unwrap('0x...')
* ```
*
* @param wrapped - Wrapped signature to unwrap.
* @returns Unwrapped signature.
*/
export function unwrap(wrapped) {
assert(wrapped);
const suffixLength = Hex.toNumber(Hex.slice(wrapped, -64, -32));
const suffix = Hex.slice(wrapped, -suffixLength - 64, -64);
const signature = Hex.slice(wrapped, 0, -suffixLength - 64);
const [auth, to, data] = AbiParameters.decode(suffixParameters, suffix);
const authorization = Authorization.from({
address: auth.delegation,
chainId: Number(auth.chainId),
nonce: auth.nonce,
yParity: auth.yParity,
r: auth.r,
s: auth.s,
});
return {
authorization,
signature,
...(data && data !== '0x' ? { data, to } : {}),
};
}
/**
* Wraps a signature into [ERC-8010 format](https://github.com/jxom/ERCs/blob/16f7e3891fff2e1e9c25dea0485497739db8a816/ERCS/erc-8010.md).
*
* @example
* ```ts twoslash
* // @noErrors
* import { Secp256k1, Signature } from 'ox'
* import { SignatureErc8010 } from 'ox/erc8010' // [!code focus]
*
* const signature = Secp256k1.sign({
* payload: '0x...',
* privateKey: '0x...',
* })
*
* const wrapped = SignatureErc8010.wrap({ // [!code focus]
* authorization: { ... }, // [!code focus]
* data: '0xdeadbeef', // [!code focus]
* signature: Signature.toHex(signature), // [!code focus]
* }) // [!code focus]
* ```
*
* @param value - Values to wrap.
* @returns Wrapped signature.
*/
export function wrap(value) {
const { data, signature } = value;
assert(value);
const self = Secp256k1.recoverAddress({
payload: Authorization.getSignPayload(value.authorization),
signature: Signature.from(value.authorization),
});
const suffix = AbiParameters.encode(suffixParameters, [
{
...value.authorization,
delegation: value.authorization.address,
chainId: BigInt(value.authorization.chainId),
},
value.to ?? self,
data ?? '0x',
]);
const suffixLength = Hex.fromNumber(Hex.size(suffix), { size: 32 });
return Hex.concat(signature, suffix, suffixLength, magicBytes);
}
/**
* Validates a wrapped signature. Returns `true` if the wrapped signature is valid, `false` otherwise.
*
* @example
* ```ts twoslash
* import { SignatureErc8010 } from 'ox/erc8010'
*
* const valid = SignatureErc8010.validate('0xdeadbeef')
* // @log: false
* ```
*
* @param value - The value to validate.
* @returns `true` if the value is valid, `false` otherwise.
*/
export function validate(value) {
try {
assert(value);
return true;
}
catch {
return false;
}
}
/** Thrown when the ERC-8010 wrapped signature is invalid. */
export class InvalidWrappedSignatureError extends Errors.BaseError {
constructor(wrapped) {
super(`Value \`${wrapped}\` is an invalid ERC-8010 wrapped signature.`);
Object.defineProperty(this, "name", {
enumerable: true,
configurable: true,
writable: true,
value: 'SignatureErc8010.InvalidWrappedSignatureError'
});
}
}
//# sourceMappingURL=SignatureErc8010.js.map