@ocap/mcrypto 1.31.9 → 1.32.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/esm/bridge-governance/evm-abi.d.mts +179 -0
  2. package/esm/bridge-governance/evm-abi.mjs +344 -0
  3. package/esm/bridge-governance/evm-proposals.d.mts +39 -0
  4. package/esm/bridge-governance/evm-proposals.mjs +345 -0
  5. package/esm/bridge-governance/evm-sync.d.mts +45 -0
  6. package/esm/bridge-governance/evm-sync.mjs +120 -0
  7. package/esm/bridge-governance/index.d.mts +8 -0
  8. package/esm/bridge-governance/index.mjs +9 -0
  9. package/esm/bridge-governance/keys.d.mts +60 -0
  10. package/esm/bridge-governance/keys.mjs +224 -0
  11. package/esm/bridge-governance/membership.d.mts +116 -0
  12. package/esm/bridge-governance/membership.mjs +175 -0
  13. package/esm/bridge-governance/ocap-proposals.d.mts +132 -0
  14. package/esm/bridge-governance/ocap-proposals.mjs +481 -0
  15. package/esm/bridge-governance/strict-json.d.mts +8 -0
  16. package/esm/bridge-governance/strict-json.mjs +102 -0
  17. package/esm/bridge-governance.d.mts +9 -116
  18. package/esm/bridge-governance.mjs +8 -174
  19. package/esm/envelope.mjs +28 -1
  20. package/esm/index.d.mts +10 -2
  21. package/esm/index.mjs +8 -2
  22. package/esm/signer/ethereum.mjs +2 -2
  23. package/esm/signer/secp256k1.d.mts +5 -0
  24. package/esm/signer/secp256k1.mjs +18 -0
  25. package/lib/_vendor/@noble/hashes/utils.cjs +19 -1
  26. package/lib/bridge-governance/evm-abi.cjs +362 -0
  27. package/lib/bridge-governance/evm-abi.d.cts +179 -0
  28. package/lib/bridge-governance/evm-proposals.cjs +353 -0
  29. package/lib/bridge-governance/evm-proposals.d.cts +39 -0
  30. package/lib/bridge-governance/evm-sync.cjs +130 -0
  31. package/lib/bridge-governance/evm-sync.d.cts +45 -0
  32. package/lib/bridge-governance/index.cjs +129 -0
  33. package/lib/bridge-governance/index.d.cts +8 -0
  34. package/lib/bridge-governance/keys.cjs +273 -0
  35. package/lib/bridge-governance/keys.d.cts +60 -0
  36. package/lib/bridge-governance/membership.cjs +195 -0
  37. package/lib/bridge-governance/membership.d.cts +116 -0
  38. package/lib/bridge-governance/ocap-proposals.cjs +491 -0
  39. package/lib/bridge-governance/ocap-proposals.d.cts +132 -0
  40. package/lib/bridge-governance/strict-json.cjs +103 -0
  41. package/lib/bridge-governance/strict-json.d.cts +8 -0
  42. package/lib/bridge-governance.cjs +128 -194
  43. package/lib/bridge-governance.d.cts +8 -116
  44. package/lib/envelope.cjs +28 -1
  45. package/lib/index.cjs +128 -21
  46. package/lib/index.d.cts +9 -2
  47. package/lib/signer/secp256k1.cjs +18 -0
  48. package/lib/signer/secp256k1.d.cts +5 -0
  49. package/package.json +2 -2
@@ -0,0 +1,129 @@
1
+ const require_bridge_governance_membership = require('./membership.cjs');
2
+ const require_bridge_governance_keys = require('./keys.cjs');
3
+ const require_bridge_governance_strict_json = require('./strict-json.cjs');
4
+ const require_bridge_governance_evm_abi = require('./evm-abi.cjs');
5
+ const require_bridge_governance_evm_sync = require('./evm-sync.cjs');
6
+ const require_bridge_governance_evm_proposals = require('./evm-proposals.cjs');
7
+ const require_bridge_governance_ocap_proposals = require('./ocap-proposals.cjs');
8
+
9
+ exports.ARC_BRIDGE_EIP712_NAME = require_bridge_governance_evm_abi.ARC_BRIDGE_EIP712_NAME;
10
+ exports.ARC_BRIDGE_EIP712_VERSION = require_bridge_governance_evm_abi.ARC_BRIDGE_EIP712_VERSION;
11
+ exports.BRIDGE_EVM_GOV_SYNC_DOMAIN_NAME = require_bridge_governance_evm_sync.BRIDGE_EVM_GOV_SYNC_DOMAIN_NAME;
12
+ exports.BRIDGE_EVM_GOV_SYNC_DOMAIN_VERSION = require_bridge_governance_evm_sync.BRIDGE_EVM_GOV_SYNC_DOMAIN_VERSION;
13
+ exports.BRIDGE_EVM_GOV_SYNC_TYPE_STRING = require_bridge_governance_evm_sync.BRIDGE_EVM_GOV_SYNC_TYPE_STRING;
14
+ exports.BRIDGE_GOV_DOC_TAG = require_bridge_governance_keys.BRIDGE_GOV_DOC_TAG;
15
+ exports.BRIDGE_GOV_DOMAIN_NAME = require_bridge_governance_membership.BRIDGE_GOV_DOMAIN_NAME;
16
+ exports.BRIDGE_GOV_DOMAIN_VERSION = require_bridge_governance_membership.BRIDGE_GOV_DOMAIN_VERSION;
17
+ exports.BRIDGE_GOV_INDEX_TAG = require_bridge_governance_keys.BRIDGE_GOV_INDEX_TAG;
18
+ exports.BRIDGE_GOV_KEY_PATTERN = require_bridge_governance_keys.BRIDGE_GOV_KEY_PATTERN;
19
+ exports.BRIDGE_MEMBERSHIP_ACTION = require_bridge_governance_membership.BRIDGE_MEMBERSHIP_ACTION;
20
+ exports.BRIDGE_MEMBERSHIP_TYPE_STRING = require_bridge_governance_membership.BRIDGE_MEMBERSHIP_TYPE_STRING;
21
+ exports.BRIDGE_OWNER_ATTESTATION_TYPE_STRING = require_bridge_governance_membership.BRIDGE_OWNER_ATTESTATION_TYPE_STRING;
22
+ exports.BRIDGE_RELEASE_BUCKET_TAG = require_bridge_governance_membership.BRIDGE_RELEASE_BUCKET_TAG;
23
+ exports.BRIDGE_RELEASE_KEY_PATTERN = require_bridge_governance_membership.BRIDGE_RELEASE_KEY_PATTERN;
24
+ exports.BRIDGE_RELEASE_TOMBSTONE_TAG = require_bridge_governance_membership.BRIDGE_RELEASE_TOMBSTONE_TAG;
25
+ exports.EVM_GOV_CONFIG_HASH_PREFIX = require_bridge_governance_keys.EVM_GOV_CONFIG_HASH_PREFIX;
26
+ exports.EVM_PROPOSAL_HASH_PREFIX = require_bridge_governance_keys.EVM_PROPOSAL_HASH_PREFIX;
27
+ exports.GOVERNANCE_CERT_TYPE_STRING = require_bridge_governance_evm_abi.GOVERNANCE_CERT_TYPE_STRING;
28
+ exports.GOVERNED_FUNCTIONS = require_bridge_governance_evm_abi.GOVERNED_FUNCTIONS;
29
+ exports.MAX_EVM_GOV_ROSTER_JSON_BYTES = require_bridge_governance_keys.MAX_EVM_GOV_ROSTER_JSON_BYTES;
30
+ exports.MAX_EVM_SIGNERS = require_bridge_governance_keys.MAX_EVM_SIGNERS;
31
+ exports.MAX_GOV_DOC_JSON_BYTES = require_bridge_governance_keys.MAX_GOV_DOC_JSON_BYTES;
32
+ exports.MAX_OCAP_DELAY_SEC = require_bridge_governance_keys.MAX_OCAP_DELAY_SEC;
33
+ exports.MAX_OCAP_PAUSERS = require_bridge_governance_keys.MAX_OCAP_PAUSERS;
34
+ exports.MAX_OCAP_VALIDATORS = require_bridge_governance_keys.MAX_OCAP_VALIDATORS;
35
+ exports.MAX_PROPOSAL_JSON_BYTES = require_bridge_governance_keys.MAX_PROPOSAL_JSON_BYTES;
36
+ exports.MAX_PROPOSAL_RATIONALE_URL_BYTES = require_bridge_governance_keys.MAX_PROPOSAL_RATIONALE_URL_BYTES;
37
+ exports.MAX_PROPOSAL_SUMMARY_BYTES = require_bridge_governance_keys.MAX_PROPOSAL_SUMMARY_BYTES;
38
+ exports.MAX_PROPOSAL_TITLE_CHARS = require_bridge_governance_keys.MAX_PROPOSAL_TITLE_CHARS;
39
+ exports.MAX_SAFE_BIGINT = require_bridge_governance_keys.MAX_SAFE_BIGINT;
40
+ exports.MAX_U256 = require_bridge_governance_keys.MAX_U256;
41
+ exports.MAX_U64 = require_bridge_governance_keys.MAX_U64;
42
+ exports.MIN_OCAP_VALIDATORS = require_bridge_governance_keys.MIN_OCAP_VALIDATORS;
43
+ exports.OCAP_PROPOSAL_HASH_PREFIX = require_bridge_governance_keys.OCAP_PROPOSAL_HASH_PREFIX;
44
+ exports.SECP256K1_HALF_N = require_bridge_governance_evm_abi.SECP256K1_HALF_N;
45
+ exports.SECP256K1_N = require_bridge_governance_evm_abi.SECP256K1_N;
46
+ exports.ZERO_ADDRESS = require_bridge_governance_keys.ZERO_ADDRESS;
47
+ exports.ZERO_BYTES32 = require_bridge_governance_keys.ZERO_BYTES32;
48
+ exports.assertAllowedKeys = require_bridge_governance_keys.assertAllowedKeys;
49
+ exports.assertBareBridgeDid = require_bridge_governance_keys.assertBareBridgeDid;
50
+ exports.assertBigIntRange = require_bridge_governance_keys.assertBigIntRange;
51
+ exports.assertBoundedPlainText = require_bridge_governance_keys.assertBoundedPlainText;
52
+ exports.assertDistinctDeploymentAddresses = require_bridge_governance_evm_abi.assertDistinctDeploymentAddresses;
53
+ exports.assertHttpUrl = require_bridge_governance_keys.assertHttpUrl;
54
+ exports.assertPlainObject = require_bridge_governance_keys.assertPlainObject;
55
+ exports.assertSafeChainId = require_bridge_governance_keys.assertSafeChainId;
56
+ exports.assertSafeUint = require_bridge_governance_keys.assertSafeUint;
57
+ exports.assertTrimmedSingleLine = require_bridge_governance_keys.assertTrimmedSingleLine;
58
+ exports.assertValidProposalTitle = require_bridge_governance_keys.assertValidProposalTitle;
59
+ exports.assertValidRationaleUrl = require_bridge_governance_keys.assertValidRationaleUrl;
60
+ exports.assertWellFormedString = require_bridge_governance_keys.assertWellFormedString;
61
+ exports.bridgeEvidenceKey = require_bridge_governance_membership.bridgeEvidenceKey;
62
+ exports.bridgeEvmGovernanceSyncDigest = require_bridge_governance_evm_sync.bridgeEvmGovernanceSyncDigest;
63
+ exports.bridgeGovDocKey = require_bridge_governance_keys.bridgeGovDocKey;
64
+ exports.bridgeGovIndexKey = require_bridge_governance_keys.bridgeGovIndexKey;
65
+ exports.bridgeReleaseBucketKey = require_bridge_governance_membership.bridgeReleaseBucketKey;
66
+ exports.bridgeReleaseTombstoneKey = require_bridge_governance_membership.bridgeReleaseTombstoneKey;
67
+ exports.buildCertFromProposal = require_bridge_governance_evm_proposals.buildCertFromProposal;
68
+ exports.buildGovernanceCert = require_bridge_governance_evm_abi.buildGovernanceCert;
69
+ exports.canonicalJson = require_bridge_governance_keys.canonicalJson;
70
+ exports.certRequestFromProposal = require_bridge_governance_evm_proposals.certRequestFromProposal;
71
+ exports.checkedBytes32 = require_bridge_governance_keys.checkedBytes32;
72
+ exports.checkedBytes4 = require_bridge_governance_keys.checkedBytes4;
73
+ exports.checkedNonEmptyHex = require_bridge_governance_keys.checkedNonEmptyHex;
74
+ exports.checkedNonZeroAddress = require_bridge_governance_keys.checkedNonZeroAddress;
75
+ exports.checksumEthAddress = require_bridge_governance_keys.checksumEthAddress;
76
+ exports.claimLargeCertExpiresAt = require_bridge_governance_evm_proposals.claimLargeCertExpiresAt;
77
+ exports.coerceEvmProposal = require_bridge_governance_evm_proposals.coerceEvmProposal;
78
+ exports.coerceOcapProposal = require_bridge_governance_ocap_proposals.coerceOcapProposal;
79
+ exports.computeArcBlockTxEip191Digest = require_bridge_governance_ocap_proposals.computeArcBlockTxEip191Digest;
80
+ exports.computeArcBlockTxEip712Digest = require_bridge_governance_ocap_proposals.computeArcBlockTxEip712Digest;
81
+ exports.computeBridgeEndpointsHash = require_bridge_governance_membership.computeBridgeEndpointsHash;
82
+ exports.computeBridgeEvmGovernanceSyncDigest = require_bridge_governance_evm_sync.computeBridgeEvmGovernanceSyncDigest;
83
+ exports.computeBridgeMembershipDigest = require_bridge_governance_membership.computeBridgeMembershipDigest;
84
+ exports.computeBridgeOwnerAttestationDigest = require_bridge_governance_membership.computeBridgeOwnerAttestationDigest;
85
+ exports.computeEvmGovernanceConfigHash = require_bridge_governance_evm_sync.computeEvmGovernanceConfigHash;
86
+ exports.computeEvmProposalHash = require_bridge_governance_evm_proposals.computeEvmProposalHash;
87
+ exports.computeGovernanceCertDigest = require_bridge_governance_evm_abi.computeGovernanceCertDigest;
88
+ exports.computeOcapProposalId = require_bridge_governance_ocap_proposals.computeOcapProposalId;
89
+ exports.computeWithdrawVoucherDigest = require_bridge_governance_evm_abi.computeWithdrawVoucherDigest;
90
+ exports.defaultCertExpiresAt = require_bridge_governance_evm_abi.defaultCertExpiresAt;
91
+ exports.ethAddressFromUncompressedPk = require_bridge_governance_keys.ethAddressFromUncompressedPk;
92
+ exports.ethAddressOfPublicKey = require_bridge_governance_membership.ethAddressOfPublicKey;
93
+ exports.formatArcBlockTxEip191Text = require_bridge_governance_ocap_proposals.formatArcBlockTxEip191Text;
94
+ exports.inBridgeGovKeySpace = require_bridge_governance_keys.inBridgeGovKeySpace;
95
+ exports.inBridgeReleaseKeySpace = require_bridge_governance_membership.inBridgeReleaseKeySpace;
96
+ exports.isBridgeGovKey = require_bridge_governance_keys.isBridgeGovKey;
97
+ exports.isBridgeReleaseKey = require_bridge_governance_membership.isBridgeReleaseKey;
98
+ exports.membershipFromOcapProposal = require_bridge_governance_ocap_proposals.membershipFromOcapProposal;
99
+ exports.normalizeEcdsaSignature = require_bridge_governance_evm_abi.normalizeEcdsaSignature;
100
+ exports.normalizeUncompressedSecp256k1Pk = require_bridge_governance_keys.normalizeUncompressedSecp256k1Pk;
101
+ exports.orderGovernanceSignatures = require_bridge_governance_evm_abi.orderGovernanceSignatures;
102
+ exports.paramsHashOf = require_bridge_governance_evm_abi.paramsHashOf;
103
+ exports.parseDecimalBigInt = require_bridge_governance_keys.parseDecimalBigInt;
104
+ exports.parseEvmGovernanceRosterConfig = require_bridge_governance_evm_sync.parseEvmGovernanceRosterConfig;
105
+ exports.parseEvmProposal = require_bridge_governance_evm_proposals.parseEvmProposal;
106
+ exports.parseOcapProposal = require_bridge_governance_ocap_proposals.parseOcapProposal;
107
+ exports.parseStrictJson = require_bridge_governance_strict_json.parseStrictJson;
108
+ exports.recoverArcBlockTxEnvelopeSigner = require_bridge_governance_ocap_proposals.recoverArcBlockTxEnvelopeSigner;
109
+ exports.recoverBridgeEvmGovernanceSyncSigner = require_bridge_governance_evm_sync.recoverBridgeEvmGovernanceSyncSigner;
110
+ exports.recoverBridgeSigner = require_bridge_governance_membership.recoverBridgeSigner;
111
+ exports.recoverGovernanceCertSigner = require_bridge_governance_evm_abi.recoverGovernanceCertSigner;
112
+ exports.recoverOcapMembershipProposalSigner = require_bridge_governance_ocap_proposals.recoverOcapMembershipProposalSigner;
113
+ exports.selectorOf = require_bridge_governance_evm_abi.selectorOf;
114
+ exports.serializeEvmGovernanceRosterConfig = require_bridge_governance_evm_sync.serializeEvmGovernanceRosterConfig;
115
+ exports.serializeEvmProposal = require_bridge_governance_evm_proposals.serializeEvmProposal;
116
+ exports.serializeOcapProposal = require_bridge_governance_ocap_proposals.serializeOcapProposal;
117
+ exports.signBridgeDigest = require_bridge_governance_membership.signBridgeDigest;
118
+ exports.signBridgeEvmGovernanceSync = require_bridge_governance_evm_sync.signBridgeEvmGovernanceSync;
119
+ exports.signGovernanceCert = require_bridge_governance_evm_abi.signGovernanceCert;
120
+ exports.signerManagerFor = require_bridge_governance_evm_abi.signerManagerFor;
121
+ exports.sortStrictChecksumAddresses = require_bridge_governance_keys.sortStrictChecksumAddresses;
122
+ exports.toHexDigest = require_bridge_governance_membership.toHexDigest;
123
+ exports.toJsonSafeValue = require_bridge_governance_keys.toJsonSafeValue;
124
+ exports.utf8ByteLength = require_bridge_governance_keys.utf8ByteLength;
125
+ exports.validateEvmGovernanceRosterConfig = require_bridge_governance_evm_sync.validateEvmGovernanceRosterConfig;
126
+ exports.validateEvmProposal = require_bridge_governance_evm_proposals.validateEvmProposal;
127
+ exports.validateGovernedRequest = require_bridge_governance_evm_abi.validateGovernedRequest;
128
+ exports.validateOcapProposal = require_bridge_governance_ocap_proposals.validateOcapProposal;
129
+ exports.verifyProposalMatchesCert = require_bridge_governance_evm_proposals.verifyProposalMatchesCert;
@@ -0,0 +1,8 @@
1
+ import { BRIDGE_GOV_DOMAIN_NAME, BRIDGE_GOV_DOMAIN_VERSION, BRIDGE_MEMBERSHIP_ACTION, BRIDGE_MEMBERSHIP_TYPE_STRING, BRIDGE_OWNER_ATTESTATION_TYPE_STRING, BRIDGE_RELEASE_BUCKET_TAG, BRIDGE_RELEASE_KEY_PATTERN, BRIDGE_RELEASE_TOMBSTONE_TAG, BridgeKeyPart, BridgeMembershipMessage, BridgeOwnerAttestationMessage, RecoveredBridgeSigner, bridgeEvidenceKey, bridgeReleaseBucketKey, bridgeReleaseTombstoneKey, computeBridgeEndpointsHash, computeBridgeMembershipDigest, computeBridgeOwnerAttestationDigest, ethAddressOfPublicKey, inBridgeReleaseKeySpace, isBridgeReleaseKey, recoverBridgeSigner, signBridgeDigest, toHexDigest } from "./membership.cjs";
2
+ import { BRIDGE_GOV_DOC_TAG, BRIDGE_GOV_INDEX_TAG, BRIDGE_GOV_KEY_PATTERN, EVM_GOV_CONFIG_HASH_PREFIX, EVM_PROPOSAL_HASH_PREFIX, MAX_EVM_GOV_ROSTER_JSON_BYTES, MAX_EVM_SIGNERS, MAX_GOV_DOC_JSON_BYTES, MAX_OCAP_DELAY_SEC, MAX_OCAP_PAUSERS, MAX_OCAP_VALIDATORS, MAX_PROPOSAL_JSON_BYTES, MAX_PROPOSAL_RATIONALE_URL_BYTES, MAX_PROPOSAL_SUMMARY_BYTES, MAX_PROPOSAL_TITLE_CHARS, MAX_SAFE_BIGINT, MAX_U256, MAX_U64, MIN_OCAP_VALIDATORS, OCAP_PROPOSAL_HASH_PREFIX, ZERO_ADDRESS, ZERO_BYTES32, assertAllowedKeys, assertBareBridgeDid, assertBigIntRange, assertBoundedPlainText, assertHttpUrl, assertPlainObject, assertSafeChainId, assertSafeUint, assertTrimmedSingleLine, assertValidProposalTitle, assertValidRationaleUrl, assertWellFormedString, bridgeGovDocKey, bridgeGovIndexKey, canonicalJson, checkedBytes32, checkedBytes4, checkedNonEmptyHex, checkedNonZeroAddress, checksumEthAddress, ethAddressFromUncompressedPk, inBridgeGovKeySpace, isBridgeGovKey, normalizeUncompressedSecp256k1Pk, parseDecimalBigInt, sortStrictChecksumAddresses, toJsonSafeValue, utf8ByteLength } from "./keys.cjs";
3
+ import { parseStrictJson } from "./strict-json.cjs";
4
+ import { ARC_BRIDGE_EIP712_NAME, ARC_BRIDGE_EIP712_VERSION, CertRequest, EvmDeployment, EvmGatewayParams, EvmWithdrawVoucher, GOVERNANCE_CERT_TYPE_STRING, GOVERNED_FUNCTIONS, GovernanceCert, GovernedAction, GovernedContract, SECP256K1_HALF_N, SECP256K1_N, assertDistinctDeploymentAddresses, buildGovernanceCert, computeGovernanceCertDigest, computeWithdrawVoucherDigest, defaultCertExpiresAt, normalizeEcdsaSignature, orderGovernanceSignatures, paramsHashOf, recoverGovernanceCertSigner, selectorOf, signGovernanceCert, signerManagerFor, validateGovernedRequest } from "./evm-abi.cjs";
5
+ import { BRIDGE_EVM_GOV_SYNC_DOMAIN_NAME, BRIDGE_EVM_GOV_SYNC_DOMAIN_VERSION, BRIDGE_EVM_GOV_SYNC_TYPE_STRING, BridgeEvmGovernanceSyncMessage, EvmGovernanceRosterConfig, EvmSignerManagerRoster, bridgeEvmGovernanceSyncDigest, computeBridgeEvmGovernanceSyncDigest, computeEvmGovernanceConfigHash, parseEvmGovernanceRosterConfig, recoverBridgeEvmGovernanceSyncSigner, serializeEvmGovernanceRosterConfig, signBridgeEvmGovernanceSync, validateEvmGovernanceRosterConfig } from "./evm-sync.cjs";
6
+ import { EvmGovernanceProposal, ExpectedEvmProposalContext, RefundContext, buildCertFromProposal, certRequestFromProposal, claimLargeCertExpiresAt, coerceEvmProposal, computeEvmProposalHash, parseEvmProposal, serializeEvmProposal, validateEvmProposal, verifyProposalMatchesCert } from "./evm-proposals.cjs";
7
+ import { ArcBlockTransactionEnvelopeFields, OcapGovernanceProposal, OcapGovernedAction, OcapMultiSigLockstep, OcapProposeOwner, OcapRollupPatch, OcapSignerRosterEntry, OcapSingleSignerMetadata, coerceOcapProposal, computeArcBlockTxEip191Digest, computeArcBlockTxEip712Digest, computeOcapProposalId, formatArcBlockTxEip191Text, membershipFromOcapProposal, parseOcapProposal, recoverArcBlockTxEnvelopeSigner, recoverOcapMembershipProposalSigner, serializeOcapProposal, validateOcapProposal } from "./ocap-proposals.cjs";
8
+ export { ARC_BRIDGE_EIP712_NAME, ARC_BRIDGE_EIP712_VERSION, ArcBlockTransactionEnvelopeFields, BRIDGE_EVM_GOV_SYNC_DOMAIN_NAME, BRIDGE_EVM_GOV_SYNC_DOMAIN_VERSION, BRIDGE_EVM_GOV_SYNC_TYPE_STRING, BRIDGE_GOV_DOC_TAG, BRIDGE_GOV_DOMAIN_NAME, BRIDGE_GOV_DOMAIN_VERSION, BRIDGE_GOV_INDEX_TAG, BRIDGE_GOV_KEY_PATTERN, BRIDGE_MEMBERSHIP_ACTION, BRIDGE_MEMBERSHIP_TYPE_STRING, BRIDGE_OWNER_ATTESTATION_TYPE_STRING, BRIDGE_RELEASE_BUCKET_TAG, BRIDGE_RELEASE_KEY_PATTERN, BRIDGE_RELEASE_TOMBSTONE_TAG, BridgeEvmGovernanceSyncMessage, BridgeKeyPart, BridgeMembershipMessage, BridgeOwnerAttestationMessage, CertRequest, EVM_GOV_CONFIG_HASH_PREFIX, EVM_PROPOSAL_HASH_PREFIX, EvmDeployment, EvmGatewayParams, EvmGovernanceProposal, EvmGovernanceRosterConfig, EvmSignerManagerRoster, EvmWithdrawVoucher, ExpectedEvmProposalContext, GOVERNANCE_CERT_TYPE_STRING, GOVERNED_FUNCTIONS, GovernanceCert, GovernedAction, GovernedContract, MAX_EVM_GOV_ROSTER_JSON_BYTES, MAX_EVM_SIGNERS, MAX_GOV_DOC_JSON_BYTES, MAX_OCAP_DELAY_SEC, MAX_OCAP_PAUSERS, MAX_OCAP_VALIDATORS, MAX_PROPOSAL_JSON_BYTES, MAX_PROPOSAL_RATIONALE_URL_BYTES, MAX_PROPOSAL_SUMMARY_BYTES, MAX_PROPOSAL_TITLE_CHARS, MAX_SAFE_BIGINT, MAX_U256, MAX_U64, MIN_OCAP_VALIDATORS, OCAP_PROPOSAL_HASH_PREFIX, OcapGovernanceProposal, OcapGovernedAction, OcapMultiSigLockstep, OcapProposeOwner, OcapRollupPatch, OcapSignerRosterEntry, OcapSingleSignerMetadata, RecoveredBridgeSigner, RefundContext, SECP256K1_HALF_N, SECP256K1_N, ZERO_ADDRESS, ZERO_BYTES32, assertAllowedKeys, assertBareBridgeDid, assertBigIntRange, assertBoundedPlainText, assertDistinctDeploymentAddresses, assertHttpUrl, assertPlainObject, assertSafeChainId, assertSafeUint, assertTrimmedSingleLine, assertValidProposalTitle, assertValidRationaleUrl, assertWellFormedString, bridgeEvidenceKey, bridgeEvmGovernanceSyncDigest, bridgeGovDocKey, bridgeGovIndexKey, bridgeReleaseBucketKey, bridgeReleaseTombstoneKey, buildCertFromProposal, buildGovernanceCert, canonicalJson, certRequestFromProposal, checkedBytes32, checkedBytes4, checkedNonEmptyHex, checkedNonZeroAddress, checksumEthAddress, claimLargeCertExpiresAt, coerceEvmProposal, coerceOcapProposal, computeArcBlockTxEip191Digest, computeArcBlockTxEip712Digest, computeBridgeEndpointsHash, computeBridgeEvmGovernanceSyncDigest, computeBridgeMembershipDigest, computeBridgeOwnerAttestationDigest, computeEvmGovernanceConfigHash, computeEvmProposalHash, computeGovernanceCertDigest, computeOcapProposalId, computeWithdrawVoucherDigest, defaultCertExpiresAt, ethAddressFromUncompressedPk, ethAddressOfPublicKey, formatArcBlockTxEip191Text, inBridgeGovKeySpace, inBridgeReleaseKeySpace, isBridgeGovKey, isBridgeReleaseKey, membershipFromOcapProposal, normalizeEcdsaSignature, normalizeUncompressedSecp256k1Pk, orderGovernanceSignatures, paramsHashOf, parseDecimalBigInt, parseEvmGovernanceRosterConfig, parseEvmProposal, parseOcapProposal, parseStrictJson, recoverArcBlockTxEnvelopeSigner, recoverBridgeEvmGovernanceSyncSigner, recoverBridgeSigner, recoverGovernanceCertSigner, recoverOcapMembershipProposalSigner, selectorOf, serializeEvmGovernanceRosterConfig, serializeEvmProposal, serializeOcapProposal, signBridgeDigest, signBridgeEvmGovernanceSync, signGovernanceCert, signerManagerFor, sortStrictChecksumAddresses, toHexDigest, toJsonSafeValue, utf8ByteLength, validateEvmGovernanceRosterConfig, validateEvmProposal, validateGovernedRequest, validateOcapProposal, verifyProposalMatchesCert };
@@ -0,0 +1,273 @@
1
+ const require_utils = require('../_vendor/@noble/hashes/utils.cjs');
2
+ const require_secp256k1 = require('../_vendor/@noble/curves/secp256k1.cjs');
3
+ const require_sha3 = require('../_vendor/@noble/hashes/sha3.cjs');
4
+
5
+ //#region src/bridge-governance/keys.ts
6
+ const BRIDGE_GOV_INDEX_TAG = "gi:";
7
+ const BRIDGE_GOV_DOC_TAG = "gd:";
8
+ /** Matches every canonical 66-char bridge governance evidence key (`gi:` or `gd:` + 63 lowercase hex chars). */
9
+ const BRIDGE_GOV_KEY_PATTERN = /^g[id]:[0-9a-f]{63}$/;
10
+ const EVM_PROPOSAL_HASH_PREFIX = "ArcBridgeGovProposalV1\n";
11
+ const OCAP_PROPOSAL_HASH_PREFIX = "ArcBridgeOcapGovProposalV1\n";
12
+ const EVM_GOV_CONFIG_HASH_PREFIX = "ArcBridgeEvmGovConfigV1\n";
13
+ const MAX_PROPOSAL_TITLE_CHARS = 160;
14
+ const MAX_PROPOSAL_SUMMARY_BYTES = 500;
15
+ const MAX_PROPOSAL_RATIONALE_URL_BYTES = 512;
16
+ const MAX_PROPOSAL_JSON_BYTES = 16 * 1024;
17
+ const MAX_GOV_DOC_JSON_BYTES = 32 * 1024;
18
+ const MAX_EVM_GOV_ROSTER_JSON_BYTES = 2 * 1024;
19
+ const MAX_EVM_SIGNERS = 32;
20
+ const MAX_OCAP_VALIDATORS = 16;
21
+ const MIN_OCAP_VALIDATORS = 3;
22
+ const MAX_OCAP_PAUSERS = 3;
23
+ const MAX_OCAP_DELAY_SEC = 2160 * 3600;
24
+ const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
25
+ const ZERO_BYTES32 = `0x${"0".repeat(64)}`;
26
+ const MAX_U64 = (1n << 64n) - 1n;
27
+ const MAX_U256 = (1n << 256n) - 1n;
28
+ const MAX_SAFE_BIGINT = BigInt(Number.MAX_SAFE_INTEGER);
29
+ const BARE_BASE58_DID_RE = /^z[1-9A-HJ-NP-Za-km-z]{20,60}$/;
30
+ const SAFE_CHAIN_ID_RE = /^[A-Za-z0-9._:-]{1,64}$/;
31
+ const FORBIDDEN_PLAIN_TEXT_RE = /[<>]|[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F\u202A-\u202E\u2066-\u2069]/;
32
+ const FORBIDDEN_SINGLE_LINE_RE = /[\r\n]/;
33
+ function utf8ByteLength(s) {
34
+ return require_utils.utf8ToBytes(s).byteLength;
35
+ }
36
+ function assertWellFormedString(val, name) {
37
+ if (typeof val !== "string") throw new Error(`${name} must be a string`);
38
+ for (let i = 0; i < val.length; i++) {
39
+ const code = val.charCodeAt(i);
40
+ if (code >= 55296 && code <= 56319) {
41
+ const next = i + 1 < val.length ? val.charCodeAt(i + 1) : 0;
42
+ if (next < 56320 || next > 57343) throw new Error(`${name} contains an unpaired UTF-16 surrogate`);
43
+ i++;
44
+ } else if (code >= 56320 && code <= 57343) throw new Error(`${name} contains an unpaired UTF-16 surrogate`);
45
+ }
46
+ return val;
47
+ }
48
+ function assertPlainObject(val, name) {
49
+ if (val === null || typeof val !== "object" || Array.isArray(val)) throw new Error(`${name} must be a plain JSON object`);
50
+ const proto = Object.getPrototypeOf(val);
51
+ if (proto !== Object.prototype && proto !== null) throw new Error(`${name} must be a plain JSON object`);
52
+ return val;
53
+ }
54
+ function assertAllowedKeys(obj, allowed, name) {
55
+ for (const key of Object.keys(obj)) if (!allowed.has(key)) throw new Error(`unexpected key "${key}" in ${name}`);
56
+ }
57
+ function assertTrimmedSingleLine(val, name, maxBytes, forbidSpace = false) {
58
+ const s = assertWellFormedString(val, name);
59
+ if (s.length === 0 || s !== s.trim()) throw new Error(`${name} must be non-empty without leading or trailing whitespace`);
60
+ if (FORBIDDEN_PLAIN_TEXT_RE.test(s) || FORBIDDEN_SINGLE_LINE_RE.test(s)) throw new Error(`${name} contains forbidden HTML, newline, control, or BiDi characters`);
61
+ if (forbidSpace && /\s/.test(s)) throw new Error(`${name} must not contain whitespace`);
62
+ if (utf8ByteLength(s) > maxBytes) throw new Error(`${name} exceeds maximum length of ${maxBytes} UTF-8 bytes`);
63
+ return s;
64
+ }
65
+ function assertBareBridgeDid(val, name = "bridge") {
66
+ const s = assertTrimmedSingleLine(val, name, 64, true);
67
+ if (/^did:abt:/i.test(s)) throw new Error(`${name} must be a bare base58btc DID without did:abt: prefix`);
68
+ if (!BARE_BASE58_DID_RE.test(s)) throw new Error(`${name} must be a bare base58btc OCAP DID`);
69
+ return s;
70
+ }
71
+ function assertSafeChainId(val, name = "ocapChainId") {
72
+ const s = assertTrimmedSingleLine(val, name, 64, true);
73
+ if (!SAFE_CHAIN_ID_RE.test(s)) throw new Error(`${name} contains invalid characters`);
74
+ return s;
75
+ }
76
+ function assertBoundedPlainText(val, name, maxBytes = MAX_PROPOSAL_SUMMARY_BYTES) {
77
+ const s = assertWellFormedString(val, name);
78
+ if (s.trim().length === 0) throw new Error(`${name} must not be empty`);
79
+ if (FORBIDDEN_PLAIN_TEXT_RE.test(s)) throw new Error(`${name} contains forbidden HTML (<, >), control, or BiDi override characters`);
80
+ if (utf8ByteLength(s) > maxBytes) throw new Error(`${name} exceeds maximum length of ${maxBytes} UTF-8 bytes`);
81
+ return s;
82
+ }
83
+ function assertValidProposalTitle(val, name = "title") {
84
+ const s = assertTrimmedSingleLine(val, name, MAX_PROPOSAL_TITLE_CHARS * 4, false);
85
+ if ([...s].length > MAX_PROPOSAL_TITLE_CHARS) throw new Error(`${name} exceeds maximum length of ${MAX_PROPOSAL_TITLE_CHARS} characters`);
86
+ return s;
87
+ }
88
+ function assertHttpUrl(val, name, httpsOnly = false, maxBytes = 256) {
89
+ const s = assertTrimmedSingleLine(val, name, maxBytes, true);
90
+ if (/["'`\\]/.test(s)) throw new Error(`${name} contains forbidden quote or backslash characters`);
91
+ let parsed;
92
+ try {
93
+ parsed = new URL(s);
94
+ } catch {
95
+ throw new Error(`${name} must be a valid HTTP(S) URL`);
96
+ }
97
+ if (httpsOnly ? parsed.protocol !== "https:" : parsed.protocol !== "https:" && parsed.protocol !== "http:") throw new Error(`${name} must use ${httpsOnly ? "https" : "http or https"} scheme`);
98
+ if (!parsed.hostname || parsed.username || parsed.password) throw new Error(`${name} must not contain URL credentials`);
99
+ return s;
100
+ }
101
+ function assertValidRationaleUrl(val, name = "rationaleUrl") {
102
+ return assertHttpUrl(val, name, true, MAX_PROPOSAL_RATIONALE_URL_BYTES);
103
+ }
104
+ /** Pure EIP-55 checksum encoder and validator (accepts all-lowercase or valid EIP-55 checksum, matching viem getAddress). */
105
+ function checksumEthAddress(raw, name = "address") {
106
+ const s = assertWellFormedString(raw, name);
107
+ if (!/^0x[0-9a-fA-F]{40}$/.test(s)) throw new Error(`${name} must be a 20-byte 0x hex Ethereum address`);
108
+ const body = s.slice(2);
109
+ const lower = body.toLowerCase();
110
+ const hashHex = require_utils.bytesToHex(require_sha3.keccak_256(require_utils.utf8ToBytes(lower)));
111
+ let checksummed = "0x";
112
+ for (let i = 0; i < 40; i++) {
113
+ const ch = lower[i];
114
+ checksummed += Number.parseInt(hashHex[i], 16) >= 8 ? ch.toUpperCase() : ch;
115
+ }
116
+ if (body !== lower && s !== checksummed) throw new Error(`${name} has an invalid EIP-55 checksum`);
117
+ return checksummed;
118
+ }
119
+ function checkedNonZeroAddress(raw, name) {
120
+ const checksummed = checksumEthAddress(raw, name);
121
+ if (checksummed === ZERO_ADDRESS) throw new Error(`${name} cannot be zero address`);
122
+ return checksummed;
123
+ }
124
+ function checkedBytes32(raw, name) {
125
+ const s = assertWellFormedString(raw, name);
126
+ if (!/^0x[0-9a-fA-F]{64}$/.test(s)) throw new Error(`${name} must be a 32-byte 0x hex string`);
127
+ return `0x${s.slice(2).toLowerCase()}`;
128
+ }
129
+ function checkedBytes4(raw, name) {
130
+ const s = assertWellFormedString(raw, name);
131
+ if (!/^0x[0-9a-fA-F]{8}$/.test(s)) throw new Error(`${name} must be a 4-byte 0x hex selector`);
132
+ return `0x${s.slice(2).toLowerCase()}`;
133
+ }
134
+ function checkedNonEmptyHex(raw, name, maxBytes) {
135
+ const s = assertWellFormedString(raw, name);
136
+ if (!/^0x(?:[0-9a-fA-F]{2})+$/.test(s)) throw new Error(`${name} must be a non-empty even-length 0x hex string`);
137
+ if ((s.length - 2) / 2 > maxBytes) throw new Error(`${name} exceeds ${maxBytes} bytes`);
138
+ return `0x${s.slice(2).toLowerCase()}`;
139
+ }
140
+ function assertBigIntRange(val, name, min, max) {
141
+ if (typeof val !== "bigint") throw new Error(`${name} must be a bigint`);
142
+ if (val < min || val > max) throw new Error(`${name} out of range [${min}, ${max}]`);
143
+ return val;
144
+ }
145
+ function parseDecimalBigInt(val, name, min, max) {
146
+ if (typeof val === "bigint") return assertBigIntRange(val, name, min, max);
147
+ if (typeof val !== "string" || !/^(?:0|[1-9][0-9]{0,77})$/.test(val)) throw new Error(`${name} must be a canonical base-10 unsigned integer string`);
148
+ return assertBigIntRange(BigInt(val), name, min, max);
149
+ }
150
+ function assertSafeUint(val, name, min, max) {
151
+ if (typeof val !== "number" || !Number.isSafeInteger(val) || val < min || val > max) throw new Error(`${name} must be a safe integer in [${min}, ${max}]`);
152
+ return val;
153
+ }
154
+ /** Sorts checksummed Ethereum addresses strictly ascending by numeric 160-bit value, rejecting duplicates. */
155
+ function sortStrictChecksumAddresses(addresses, label = "addresses") {
156
+ const sorted = [...addresses.map((a, i) => checkedNonZeroAddress(a, `${label}[${i}]`))].sort((a, b) => BigInt(a) < BigInt(b) ? -1 : BigInt(a) > BigInt(b) ? 1 : 0);
157
+ for (let i = 1; i < sorted.length; i++) if (sorted[i] === sorted[i - 1]) throw new Error(`duplicate address ${sorted[i]} in ${label}`);
158
+ return sorted;
159
+ }
160
+ function normalizeUncompressedSecp256k1Pk(pk) {
161
+ const s = assertWellFormedString(pk, "pk");
162
+ const m = /^(?:0x)?([0-9a-fA-F]{128})$/.exec(s) ?? /^(?:0x)?04([0-9a-fA-F]{128})$/.exec(s);
163
+ if (!m?.[1]) throw new Error("secp256k1 public key must be 64-byte (128 hex) or 65-byte (04 + 128 hex) uncompressed hex");
164
+ const normalized = m[1].toLowerCase();
165
+ require_secp256k1.secp256k1.Point.fromHex(`04${normalized}`);
166
+ return `0x${normalized}`;
167
+ }
168
+ function ethAddressFromUncompressedPk(pk) {
169
+ return checkedNonZeroAddress(`0x${require_utils.bytesToHex(require_sha3.keccak_256(require_utils.hexToBytes(normalizeUncompressedSecp256k1Pk(pk).slice(2))).subarray(12))}`, "derived pk address");
170
+ }
171
+ /** Deterministic 66-character `statedb.evidence` key (`gi:<63hex>`) for the per-bridge proposal ring index. */
172
+ function bridgeGovIndexKey(bridge) {
173
+ const normalizedBridge = assertBareBridgeDid(bridge, "bridge");
174
+ return `${BRIDGE_GOV_INDEX_TAG}${require_utils.bytesToHex(require_sha3.keccak_256(require_utils.concatBytes(require_utils.utf8ToBytes("arc-bridge:gov-index:"), require_utils.utf8ToBytes(normalizedBridge)))).slice(0, 63)}`;
175
+ }
176
+ /** Deterministic 66-character `statedb.evidence` key (`gd:<63hex>`) for a bridge governance proposal document. */
177
+ function bridgeGovDocKey(bridge, proposalId) {
178
+ const normalizedBridge = assertBareBridgeDid(bridge, "bridge");
179
+ const idBytes = require_utils.hexToBytes(checkedBytes32(proposalId, "proposalId").slice(2));
180
+ return `${BRIDGE_GOV_DOC_TAG}${require_utils.bytesToHex(require_sha3.keccak_256(require_utils.concatBytes(require_utils.utf8ToBytes("arc-bridge:gov-doc:"), require_utils.utf8ToBytes(normalizedBridge), idBytes))).slice(0, 63)}`;
181
+ }
182
+ function isBridgeGovKey(key) {
183
+ return typeof key === "string" && BRIDGE_GOV_KEY_PATTERN.test(key);
184
+ }
185
+ function inBridgeGovKeySpace(key) {
186
+ return typeof key === "string" && /^g[id]:/i.test(key.trim());
187
+ }
188
+ /** Canonical JSON serializer (lexicographically sorted keys, finite numbers only, no undefined/BigInt). */
189
+ function canonicalJson(value) {
190
+ if (value === null || typeof value === "boolean") return JSON.stringify(value);
191
+ if (typeof value === "number") {
192
+ if (!Number.isFinite(value)) throw new Error("canonicalJson: non-finite number");
193
+ return JSON.stringify(value);
194
+ }
195
+ if (typeof value === "string") return JSON.stringify(value);
196
+ if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
197
+ if (typeof value === "object") {
198
+ const record = value;
199
+ const parts = [];
200
+ for (const k of Object.keys(record).sort()) {
201
+ const v = record[k];
202
+ if (v === void 0) throw new Error(`canonicalJson: undefined at key "${k}"`);
203
+ parts.push(`${JSON.stringify(k)}:${canonicalJson(v)}`);
204
+ }
205
+ return `{${parts.join(",")}}`;
206
+ }
207
+ throw new Error(`canonicalJson: unsupported type ${typeof value}`);
208
+ }
209
+ /** Converts `bigint` leaves to decimal strings while omitting `undefined` object properties. */
210
+ function toJsonSafeValue(value) {
211
+ if (typeof value === "bigint") return value.toString(10);
212
+ if (value === null || typeof value === "boolean" || typeof value === "number" || typeof value === "string") return value;
213
+ if (Array.isArray(value)) return value.map(toJsonSafeValue);
214
+ if (typeof value === "object") {
215
+ const src = value;
216
+ const out = {};
217
+ for (const key of Object.keys(src)) if (src[key] !== void 0) out[key] = toJsonSafeValue(src[key]);
218
+ return out;
219
+ }
220
+ throw new Error(`Unsupported value type in proposal serialization: ${typeof value}`);
221
+ }
222
+
223
+ //#endregion
224
+ exports.BRIDGE_GOV_DOC_TAG = BRIDGE_GOV_DOC_TAG;
225
+ exports.BRIDGE_GOV_INDEX_TAG = BRIDGE_GOV_INDEX_TAG;
226
+ exports.BRIDGE_GOV_KEY_PATTERN = BRIDGE_GOV_KEY_PATTERN;
227
+ exports.EVM_GOV_CONFIG_HASH_PREFIX = EVM_GOV_CONFIG_HASH_PREFIX;
228
+ exports.EVM_PROPOSAL_HASH_PREFIX = EVM_PROPOSAL_HASH_PREFIX;
229
+ exports.MAX_EVM_GOV_ROSTER_JSON_BYTES = MAX_EVM_GOV_ROSTER_JSON_BYTES;
230
+ exports.MAX_EVM_SIGNERS = MAX_EVM_SIGNERS;
231
+ exports.MAX_GOV_DOC_JSON_BYTES = MAX_GOV_DOC_JSON_BYTES;
232
+ exports.MAX_OCAP_DELAY_SEC = MAX_OCAP_DELAY_SEC;
233
+ exports.MAX_OCAP_PAUSERS = MAX_OCAP_PAUSERS;
234
+ exports.MAX_OCAP_VALIDATORS = MAX_OCAP_VALIDATORS;
235
+ exports.MAX_PROPOSAL_JSON_BYTES = MAX_PROPOSAL_JSON_BYTES;
236
+ exports.MAX_PROPOSAL_RATIONALE_URL_BYTES = MAX_PROPOSAL_RATIONALE_URL_BYTES;
237
+ exports.MAX_PROPOSAL_SUMMARY_BYTES = MAX_PROPOSAL_SUMMARY_BYTES;
238
+ exports.MAX_PROPOSAL_TITLE_CHARS = MAX_PROPOSAL_TITLE_CHARS;
239
+ exports.MAX_SAFE_BIGINT = MAX_SAFE_BIGINT;
240
+ exports.MAX_U256 = MAX_U256;
241
+ exports.MAX_U64 = MAX_U64;
242
+ exports.MIN_OCAP_VALIDATORS = MIN_OCAP_VALIDATORS;
243
+ exports.OCAP_PROPOSAL_HASH_PREFIX = OCAP_PROPOSAL_HASH_PREFIX;
244
+ exports.ZERO_ADDRESS = ZERO_ADDRESS;
245
+ exports.ZERO_BYTES32 = ZERO_BYTES32;
246
+ exports.assertAllowedKeys = assertAllowedKeys;
247
+ exports.assertBareBridgeDid = assertBareBridgeDid;
248
+ exports.assertBigIntRange = assertBigIntRange;
249
+ exports.assertBoundedPlainText = assertBoundedPlainText;
250
+ exports.assertHttpUrl = assertHttpUrl;
251
+ exports.assertPlainObject = assertPlainObject;
252
+ exports.assertSafeChainId = assertSafeChainId;
253
+ exports.assertSafeUint = assertSafeUint;
254
+ exports.assertTrimmedSingleLine = assertTrimmedSingleLine;
255
+ exports.assertValidProposalTitle = assertValidProposalTitle;
256
+ exports.assertValidRationaleUrl = assertValidRationaleUrl;
257
+ exports.assertWellFormedString = assertWellFormedString;
258
+ exports.bridgeGovDocKey = bridgeGovDocKey;
259
+ exports.bridgeGovIndexKey = bridgeGovIndexKey;
260
+ exports.canonicalJson = canonicalJson;
261
+ exports.checkedBytes32 = checkedBytes32;
262
+ exports.checkedBytes4 = checkedBytes4;
263
+ exports.checkedNonEmptyHex = checkedNonEmptyHex;
264
+ exports.checkedNonZeroAddress = checkedNonZeroAddress;
265
+ exports.checksumEthAddress = checksumEthAddress;
266
+ exports.ethAddressFromUncompressedPk = ethAddressFromUncompressedPk;
267
+ exports.inBridgeGovKeySpace = inBridgeGovKeySpace;
268
+ exports.isBridgeGovKey = isBridgeGovKey;
269
+ exports.normalizeUncompressedSecp256k1Pk = normalizeUncompressedSecp256k1Pk;
270
+ exports.parseDecimalBigInt = parseDecimalBigInt;
271
+ exports.sortStrictChecksumAddresses = sortStrictChecksumAddresses;
272
+ exports.toJsonSafeValue = toJsonSafeValue;
273
+ exports.utf8ByteLength = utf8ByteLength;
@@ -0,0 +1,60 @@
1
+ //#region src/bridge-governance/keys.d.ts
2
+ declare const BRIDGE_GOV_INDEX_TAG = "gi:";
3
+ declare const BRIDGE_GOV_DOC_TAG = "gd:";
4
+ /** Matches every canonical 66-char bridge governance evidence key (`gi:` or `gd:` + 63 lowercase hex chars). */
5
+ declare const BRIDGE_GOV_KEY_PATTERN: RegExp;
6
+ declare const EVM_PROPOSAL_HASH_PREFIX = "ArcBridgeGovProposalV1\n";
7
+ declare const OCAP_PROPOSAL_HASH_PREFIX = "ArcBridgeOcapGovProposalV1\n";
8
+ declare const EVM_GOV_CONFIG_HASH_PREFIX = "ArcBridgeEvmGovConfigV1\n";
9
+ declare const MAX_PROPOSAL_TITLE_CHARS = 160;
10
+ declare const MAX_PROPOSAL_SUMMARY_BYTES = 500;
11
+ declare const MAX_PROPOSAL_RATIONALE_URL_BYTES = 512;
12
+ declare const MAX_PROPOSAL_JSON_BYTES: number;
13
+ declare const MAX_GOV_DOC_JSON_BYTES: number;
14
+ declare const MAX_EVM_GOV_ROSTER_JSON_BYTES: number;
15
+ declare const MAX_EVM_SIGNERS = 32;
16
+ declare const MAX_OCAP_VALIDATORS = 16;
17
+ declare const MIN_OCAP_VALIDATORS = 3;
18
+ declare const MAX_OCAP_PAUSERS = 3;
19
+ declare const MAX_OCAP_DELAY_SEC: number;
20
+ declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
21
+ declare const ZERO_BYTES32: string;
22
+ declare const MAX_U64: bigint;
23
+ declare const MAX_U256: bigint;
24
+ declare const MAX_SAFE_BIGINT: bigint;
25
+ declare function utf8ByteLength(s: string): number;
26
+ declare function assertWellFormedString(val: unknown, name: string): string;
27
+ declare function assertPlainObject(val: unknown, name: string): Record<string, unknown>;
28
+ declare function assertAllowedKeys(obj: Record<string, unknown>, allowed: ReadonlySet<string>, name: string): void;
29
+ declare function assertTrimmedSingleLine(val: unknown, name: string, maxBytes: number, forbidSpace?: boolean): string;
30
+ declare function assertBareBridgeDid(val: unknown, name?: string): string;
31
+ declare function assertSafeChainId(val: unknown, name?: string): string;
32
+ declare function assertBoundedPlainText(val: unknown, name: string, maxBytes?: number): string;
33
+ declare function assertValidProposalTitle(val: unknown, name?: string): string;
34
+ declare function assertHttpUrl(val: unknown, name: string, httpsOnly?: boolean, maxBytes?: number): string;
35
+ declare function assertValidRationaleUrl(val: unknown, name?: string): string;
36
+ /** Pure EIP-55 checksum encoder and validator (accepts all-lowercase or valid EIP-55 checksum, matching viem getAddress). */
37
+ declare function checksumEthAddress(raw: unknown, name?: string): string;
38
+ declare function checkedNonZeroAddress(raw: unknown, name: string): string;
39
+ declare function checkedBytes32(raw: unknown, name: string): string;
40
+ declare function checkedBytes4(raw: unknown, name: string): string;
41
+ declare function checkedNonEmptyHex(raw: unknown, name: string, maxBytes: number): string;
42
+ declare function assertBigIntRange(val: unknown, name: string, min: bigint, max: bigint): bigint;
43
+ declare function parseDecimalBigInt(val: unknown, name: string, min: bigint, max: bigint): bigint;
44
+ declare function assertSafeUint(val: unknown, name: string, min: number, max: number): number;
45
+ /** Sorts checksummed Ethereum addresses strictly ascending by numeric 160-bit value, rejecting duplicates. */
46
+ declare function sortStrictChecksumAddresses(addresses: readonly string[], label?: string): string[];
47
+ declare function normalizeUncompressedSecp256k1Pk(pk: string): string;
48
+ declare function ethAddressFromUncompressedPk(pk: string): string;
49
+ /** Deterministic 66-character `statedb.evidence` key (`gi:<63hex>`) for the per-bridge proposal ring index. */
50
+ declare function bridgeGovIndexKey(bridge: string): string;
51
+ /** Deterministic 66-character `statedb.evidence` key (`gd:<63hex>`) for a bridge governance proposal document. */
52
+ declare function bridgeGovDocKey(bridge: string, proposalId: string): string;
53
+ declare function isBridgeGovKey(key: unknown): key is string;
54
+ declare function inBridgeGovKeySpace(key: unknown): boolean;
55
+ /** Canonical JSON serializer (lexicographically sorted keys, finite numbers only, no undefined/BigInt). */
56
+ declare function canonicalJson(value: unknown): string;
57
+ /** Converts `bigint` leaves to decimal strings while omitting `undefined` object properties. */
58
+ declare function toJsonSafeValue(value: unknown): unknown;
59
+ //#endregion
60
+ export { BRIDGE_GOV_DOC_TAG, BRIDGE_GOV_INDEX_TAG, BRIDGE_GOV_KEY_PATTERN, EVM_GOV_CONFIG_HASH_PREFIX, EVM_PROPOSAL_HASH_PREFIX, MAX_EVM_GOV_ROSTER_JSON_BYTES, MAX_EVM_SIGNERS, MAX_GOV_DOC_JSON_BYTES, MAX_OCAP_DELAY_SEC, MAX_OCAP_PAUSERS, MAX_OCAP_VALIDATORS, MAX_PROPOSAL_JSON_BYTES, MAX_PROPOSAL_RATIONALE_URL_BYTES, MAX_PROPOSAL_SUMMARY_BYTES, MAX_PROPOSAL_TITLE_CHARS, MAX_SAFE_BIGINT, MAX_U256, MAX_U64, MIN_OCAP_VALIDATORS, OCAP_PROPOSAL_HASH_PREFIX, ZERO_ADDRESS, ZERO_BYTES32, assertAllowedKeys, assertBareBridgeDid, assertBigIntRange, assertBoundedPlainText, assertHttpUrl, assertPlainObject, assertSafeChainId, assertSafeUint, assertTrimmedSingleLine, assertValidProposalTitle, assertValidRationaleUrl, assertWellFormedString, bridgeGovDocKey, bridgeGovIndexKey, canonicalJson, checkedBytes32, checkedBytes4, checkedNonEmptyHex, checkedNonZeroAddress, checksumEthAddress, ethAddressFromUncompressedPk, inBridgeGovKeySpace, isBridgeGovKey, normalizeUncompressedSecp256k1Pk, parseDecimalBigInt, sortStrictChecksumAddresses, toJsonSafeValue, utf8ByteLength };