@resurrect-protocol/contracts 0.1.0-dev.12.1

package/README.md

@@ -0,0 +1,17 @@
+# `@resurrect-protocol/contracts`
+
+Canonical, permissionless Resurrect Registry v1 Solidity source and ABI. The contract is stateless and has no owner, administrator, allowlist, pause, upgrade, withdrawal, or peer-storage path. Anyone may publish a bounded signed peer record. Applications consume recent `PeerAnnounced` logs as untrusted discovery hints.
+
+```bash
+npm install @resurrect-protocol/contracts
+```
+
+```js
+import registryAbi from '@resurrect-protocol/contracts/abi/ResurrectRegistryV1.json' with { type: 'json' }
+```
+
+Solidity tools can import `@resurrect-protocol/contracts/src/ResurrectRegistryV1.sol`. The source exposes exactly `VERSION`, `MAX_TTL`, `MAX_RECORD_BYTES`, and `announce`. TTL must be between one second and 90 days; records must be between one and 4096 bytes. Expiry is computed from the block timestamp and emitted with the namespace, codec, and bytes.
+
+The source is released under [CC0-1.0](https://creativecommons.org/publicdomain/zero/1.0/). Consumers should deploy and verify the exact source themselves, then pin the chain ID, address, deployment block, and constants in their application descriptor. This package does not designate or endorse a production deployment.
+
+An onchain event is an untrusted discovery hint. Consumers must still verify the embedded signed peer record, sequence, expiry, endpoint policy, and application handshake.

package/abi/ResurrectRegistryV1.json

@@ -0,0 +1,48 @@
+[
+  {
+    "type": "function",
+    "name": "MAX_RECORD_BYTES",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "uint32", "internalType": "uint32" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "MAX_TTL",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "uint32", "internalType": "uint32" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "VERSION",
+    "inputs": [],
+    "outputs": [{ "name": "", "type": "uint32", "internalType": "uint32" }],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "announce",
+    "inputs": [
+      { "name": "namespace", "type": "bytes32", "internalType": "bytes32" },
+      { "name": "recordType", "type": "uint32", "internalType": "uint32" },
+      { "name": "ttl", "type": "uint32", "internalType": "uint32" },
+      { "name": "peerRecord", "type": "bytes", "internalType": "bytes" }
+    ],
+    "outputs": [],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "event",
+    "name": "PeerAnnounced",
+    "inputs": [
+      { "name": "namespace", "type": "bytes32", "indexed": true, "internalType": "bytes32" },
+      { "name": "recordType", "type": "uint32", "indexed": true, "internalType": "uint32" },
+      { "name": "validUntil", "type": "uint64", "indexed": false, "internalType": "uint64" },
+      { "name": "peerRecord", "type": "bytes", "indexed": false, "internalType": "bytes" }
+    ],
+    "anonymous": false
+  },
+  { "type": "error", "name": "InvalidTTL", "inputs": [] },
+  { "type": "error", "name": "RecordTooLarge", "inputs": [] }
+]

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@resurrect-protocol/contracts",
+  "version": "0.1.0-dev.12.1",
+  "description": "Canonical immutable Solidity registry source and ABI for Resurrect v1",
+  "license": "CC0-1.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cazala/resurrect.git",
+    "directory": "packages/contracts"
+  },
+  "homepage": "https://github.com/cazala/resurrect",
+  "files": [
+    "abi",
+    "src",
+    "README.md"
+  ],
+  "exports": {
+    "./abi/ResurrectRegistryV1.json": "./abi/ResurrectRegistryV1.json",
+    "./src/ResurrectRegistryV1.sol": "./src/ResurrectRegistryV1.sol"
+  },
+  "scripts": {
+    "build": "node -e \"JSON.parse(require('node:fs').readFileSync('abi/ResurrectRegistryV1.json'))\"",
+    "check": "node -e \"JSON.parse(require('node:fs').readFileSync('abi/ResurrectRegistryV1.json'))\"",
+    "test": "node -e \"JSON.parse(require('node:fs').readFileSync('abi/ResurrectRegistryV1.json'))\""
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/src/ResurrectRegistryV1.sol

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity 0.8.24;
+
+/// @title Resurrect registry v1
+/// @notice Permissionless, immutable, log-only rendezvous for signed peer records.
+/// @dev This contract deliberately has no owner, storage, upgrade, pause, or withdrawal path.
+contract ResurrectRegistryV1 {
+    uint32 public constant VERSION = 1;
+    uint32 public constant MAX_TTL = 90 days;
+    uint32 public constant MAX_RECORD_BYTES = 4096;
+
+    error InvalidTTL();
+    error RecordTooLarge();
+
+    event PeerAnnounced(
+        bytes32 indexed namespace, uint32 indexed recordType, uint64 validUntil, bytes peerRecord
+    );
+
+    /// @notice Publishes a bounded-lifetime, application-namespaced signed peer record.
+    /// @param namespace Application/network isolation identifier.
+    /// @param recordType Resurrect peer-record codec identifier.
+    /// @param ttl Lifetime in seconds, bounded by `MAX_TTL`.
+    /// @param peerRecord Raw self-authenticating peer-record bytes.
+    function announce(bytes32 namespace, uint32 recordType, uint32 ttl, bytes calldata peerRecord)
+        external
+    {
+        if (ttl == 0 || ttl > MAX_TTL) revert InvalidTTL();
+        if (peerRecord.length == 0 || peerRecord.length > MAX_RECORD_BYTES) {
+            revert RecordTooLarge();
+        }
+
+        emit PeerAnnounced(namespace, recordType, uint64(block.timestamp) + uint64(ttl), peerRecord);
+    }
+}