construct-the-orchard

Apply a community-input-driven trait change to a token. Updates metadata + image, re-pins, prepares the protocol-side contract call. The act-skill of the customization cluster.

Lift a collection's metadata + images off a defunct pinner (e.g. the dead mibera metadata service) onto Freeside + IPFS dual-pin. Recovery skill — the construct's first cultivation event.

Upload metadata JSON and image assets to Freeside (Honey Jar's own infra) and return immutable URIs. Vendor implementation for the primary pin under the dual-pin policy.

Pin metadata + image to IPFS via the configured pinner (Pinata, nft.storage, web3.storage, or self-hosted). Vendor implementation for the fallback pin under the dual-pin policy. Decentralized survival layer.

Rotate a collection's on-chain baseURI from a stale source (defunct pinner, sunset domain, deprecated route) to a new sound source (thj-assets CloudFront, Next.js metadata API, freshly migrated S3 prefix). Pre-flight verifies the new URI resolves end-to-end before any tx; post-flight forces marketplace re-index. Companion to migrating-storage.

Plan a time-locked operational event — mint, graft drop, harvest event — with substrate pre-flight, broadcast composition, and on-landing verification. Operational moment within a cultivating-cycle.

Recover metadata from a defunct or unreliable source (dead Irys gateway, unreachable IPFS CIDs, sunset vendor) and stage it at a new healthy endpoint ready for rotation. The data-side companion to rotating-baseURI.

Replace a token's image — composes with the-mint when regeneration is needed — re-pin both image and metadata, update the metadata's image-hash reference. Image specialization of grafting-traits.

Edit a token's JSON metadata in-place — attribute swap, name correction, description update — and re-pin under dual-pin policy. JSON-only specialization of grafting-traits.

Documents and validates the canonical 0xHoneyJar metadata-serving substrate — Postgres-row-as-source-of-truth, Next.js dynamic route as the wire boundary, CloudFront-fronted thj-assets for image bytes. The architectural reference; staging-recovery is the operational act that targets it.

The orchard's primary skill. Tends the storage substrate — dual-pin policy (Freeside primary + IPFS fallback), pin verification, regeneration when drift surfaces. Every other skill in the construct depends on this substrate being sound.

Confirm a graft landed both on-chain and on the pinner. Reads tokenURI from the contract, resolves it, hashes the result, and confirms it matches the mutation-log entry. Read-only Verdict emitter.

Orchestrate one cultivation cycle for a collection — plan → drop/harvest/graft → retro. Top-level act-skill of the events cluster. Scopes a coherent operational rhythm rather than ad-hoc moments.

Collect community proposals during an open-input window — Discord threads, Twitter polls, governance votes — and structure them into a graft-proposal queue. Input collection in service of cultivation.

Close a cultivation cycle by authoring its retro — what landed, what surprised, what next-cycle should know. Composes with KEEPER for cultural learning. The cycle's load-bearing output.

Probe a pinned URI (Freeside or IPFS) and confirm it resolves to content matching the recorded hash. Returns a Verdict the dual-pin policy enforcement reads.