Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 20 additions & 20 deletions docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
# Standalone HTML UI: `agijobmanager_genesis_job_mainnet_2026-03-05-v43.html`
# Standalone HTML UI: `agijobmanager_genesis_job_mainnet_2026-03-05-v44.html`

## At-a-glance navigation

- [Quick start (safe and practical)](#quick-start-safe-and-practical)
- [Embedded network and contract assumptions (v43)](#embedded-network-and-contract-assumptions-v43)
- [Embedded network and contract assumptions (v44)](#embedded-network-and-contract-assumptions-v44)
- [Security and trust hygiene](#security-and-trust-hygiene)
- [Troubleshooting (standalone page)](#troubleshooting-standalone-page)
- [What this page does not replace](#what-this-page-does-not-replace)
- [Standalone artifact inventory](./STANDALONE_HTML_UIS.md)

## What this page is

`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html` is a **standalone, versioned HTML interface artifact** for AGIJobManager mainnet operations and demonstrations.
`ui/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html` is a **standalone, versioned HTML interface artifact** for AGIJobManager mainnet operations and demonstrations.

Version/lifecycle posture:
- This file is a point-in-time artifact (`v43`) committed in-repo for reproducible browser-based operations and review.
- This file is a point-in-time artifact (`v44`) committed in-repo for reproducible browser-based operations and review.
- It is intentionally additive to the broader/full UI effort (Next.js app in `ui/src/`, docs in [docs/ui/README.md](./README.md)).
- It is not the deployment authority and not a replacement for Hardhat runbooks.

Expand Down Expand Up @@ -48,7 +48,7 @@ Do not use it as a deployment source of truth:

This page is a UI client for that ecosystem, not a deployment framework.

## Grounded capabilities in v43
## Grounded capabilities in v44

Based on the file contents, this standalone page includes:

Expand All @@ -63,11 +63,11 @@ Based on the file contents, this standalone page includes:
- `$AGIALPHA` bridge/conversion console (deBridge widget embedding plus `depositExact` flow into `AGIALPHAEqualMinterVault`).
- Embedded Terms & Conditions section and in-page acceptance gating for write controls.

Grounding note: this list is based on visible controls, embedded ABIs, and in-page handlers in the `v43` file.
Grounding note: this list is based on visible controls, embedded ABIs, and in-page handlers in the `v44` file.

Alpha identity review modal is a single canonical signing surface fed by a normalized preview(label)+rootHealth() snapshot. The public register route directly signs `register(string)` on `FreeTrialSubdomainRegistrarIdentity` with `value = 0` on mainnet.

## Grounded page sections and expected outcomes (v43)
## Grounded page sections and expected outcomes (v44)

| Section in page | What you do there | Expected result |
| --- | --- | --- |
Expand All @@ -77,7 +77,7 @@ Alpha identity review modal is a single canonical signing surface fed by a norma
| AGIALPHA bridge/conversion area | Review bridged vs official balances, run approval, run vault conversion, optionally use embedded deBridge route. | Bridged token can be converted into official Ethereum `$AGIALPHA` (when wallet and vault state permit). |
| Terms & Conditions area | Review and accept embedded terms. | Write controls remain intentionally locked until terms are accepted in-page. |

Inference boundary: this table describes visible UX and method wiring present in `v43`; it does not redefine protocol-level permissions.
Inference boundary: this table describes visible UX and method wiring present in `v44`; it does not redefine protocol-level permissions.

## Grounded non-goals (important)

Expand All @@ -102,7 +102,7 @@ This section maps major UI actions to the contract methods surfaced in the file'

If uncertain about exact callable semantics, confirm against contract docs/runbooks before signing.

## Write-capable transaction methods exposed in v43
## Write-capable transaction methods exposed in v44

The standalone page includes handlers that can submit the following transactions (subject to role/state checks enforced by contracts):

Expand Down Expand Up @@ -131,7 +131,7 @@ Primary:
- Reviewers/auditors/demo participants validating end-to-end operator UX without running the full Next.js stack.

Secondary:
- Developers comparing standalone snapshots (`v13` ... `v43`) during UI iteration.
- Developers comparing standalone snapshots (`v13` ... `v44`) during UI iteration.

## Quick start (safe and practical)

Expand All @@ -145,7 +145,7 @@ python3 -m http.server 8000
Open:

```text
http://127.0.0.1:8000/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html
http://127.0.0.1:8000/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html
```

(Direct `file://` open can work, but local HTTP is more reliable for wallet/provider behavior.)
Expand All @@ -168,7 +168,7 @@ No local backend, indexer, or database is required for this standalone page.
### Open method

Use either:
1. Direct file open (`file://.../ui/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html`), or
1. Direct file open (`file://.../ui/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html`), or
2. Serve over HTTP from repository root.

Recommended HTTP approach:
Expand All @@ -181,7 +181,7 @@ python3 -m http.server 8000
Then open:

```text
http://localhost:8000/ui/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html
http://localhost:8000/ui/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html
```

HTTP serving is generally safer for extension compatibility and future browser restrictions.
Expand All @@ -197,7 +197,7 @@ HTTP serving is generally safer for extension compatibility and future browser r
### Minimal safe operating sequence

1. Open via local HTTP.
2. Confirm filename/path ends with `agijobmanager_genesis_job_mainnet_2026-03-05-v43.html`.
2. Confirm filename/path ends with `agijobmanager_genesis_job_mainnet_2026-03-05-v44.html`.
3. Connect wallet and confirm Ethereum Mainnet.
4. Confirm address panel values against deployment docs.
5. Accept terms in-page.
Expand Down Expand Up @@ -239,12 +239,12 @@ Use this checklist before each write transaction:
- **Read-only (no wallet):** You can view static sections and most dashboard content, but cannot submit on-chain transactions.
- **Action-capable (wallet + mainnet + terms accepted):** Write buttons unlock and the page can submit contract transactions through your wallet.

Write-gate conditions in v43 are explicitly tied to:
Write-gate conditions in v44 are explicitly tied to:
1. wallet connection,
2. Ethereum mainnet (`chainId 1`), and
3. in-page terms acceptance checkbox.

## Embedded network and contract assumptions (v43)
## Embedded network and contract assumptions (v44)

The page hardcodes the following addresses/constants in the script block:

Expand All @@ -269,11 +269,11 @@ The broader UI is a separate Next.js surface that continues to evolve in paralle
- Broader UI docs hub: [docs/ui/README.md](./README.md)
- UI directory inventory (artifact + app): [ui/README.md](../../ui/README.md)

Use this `v43` runbook when you intentionally need a single-file, versioned browser interface. Use the broader UI docs when you need roadmap/development/testing context.
Use this `v44` runbook when you intentionally need a single-file, versioned browser interface. Use the broader UI docs when you need roadmap/development/testing context.

## Relationship to other UI artifacts in `ui/`

- `v43` is the documented standalone artifact for this runbook.
- `v44` is the documented standalone artifact for this runbook.
- Other `agijobmanager_genesis_job_mainnet_2026-03-05-v*.html` files are adjacent snapshots for comparison/reproducibility.
- The Next.js app in `ui/` remains the broader/full UI effort under active development.

Expand Down Expand Up @@ -327,7 +327,7 @@ Operationally, AGIJobManager settlement/dispute outcomes remain authoritative ev

## Status and lifecycle

- This file documents a **versioned standalone artifact**: `v43`.
- This file documents a **versioned standalone artifact**: `v44`.
- It is intended as an additive, practical browser interface for current operator/reviewer workflows.
- The broader/full UI effort is still in active development in `ui/` (Next.js surface) and tracked in [docs/ui/README.md](./README.md).
- When operational guidance conflicts, treat deployment/operator docs and on-chain contract behavior as canonical.
Expand All @@ -352,7 +352,7 @@ For full UI development and operations docs, use:

### Write buttons remain disabled

Typical causes in v43:
Typical causes in v44:
- Wallet not connected.
- Not on Ethereum Mainnet.
- Terms not accepted in-page.
Expand Down
4 changes: 2 additions & 2 deletions docs/ui/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
Institutional-grade Next.js dApp + operations console with **read-only first**, **simulation-first writes**, and deterministic demo mode.

## Quick links
- [Standalone Genesis Mainnet HTML UI (`v43`)](./GENESIS_JOB_MAINNET_HTML_UI.md)
- [Standalone Genesis Mainnet HTML UI (`v44`)](./GENESIS_JOB_MAINNET_HTML_UI.md)
- [Standalone HTML artifact index (`ui/*.html`)](./STANDALONE_HTML_UIS.md)
- [UI directory inventory (`/ui`)](../../ui/README.md)
- [Overview](./OVERVIEW.md)
Expand Down Expand Up @@ -50,7 +50,7 @@ This folder is **text-only**. Binary assets are forbidden and CI-enforced by `np

## Standalone HTML artifact (additive)

For the versioned, single-file mainnet page in `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html`, use:
For the versioned, single-file mainnet page in `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html`, use:

- [GENESIS_JOB_MAINNET_HTML_UI.md](./GENESIS_JOB_MAINNET_HTML_UI.md)
- [STANDALONE_HTML_UIS.md](./STANDALONE_HTML_UIS.md)
Expand Down
10 changes: 5 additions & 5 deletions docs/ui/STANDALONE_HTML_UIS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ These files are **additive** to the broader Next.js UI effort in `ui/`; they are

## Canonical routing

- **Primary operator runbook for the documented mainnet artifact (`v43`):** [GENESIS_JOB_MAINNET_HTML_UI.md](./GENESIS_JOB_MAINNET_HTML_UI.md)
- **Primary operator runbook for the documented mainnet artifact (`v44`):** [GENESIS_JOB_MAINNET_HTML_UI.md](./GENESIS_JOB_MAINNET_HTML_UI.md)
- **Broader/full UI docs hub (Next.js):** [README.md](./README.md)
- **Deployment/operator authority (Hardhat):** [../../hardhat/README.md](../../hardhat/README.md)
- **ENS replacement/cutover flow:** [../DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md](../DEPLOYMENT/ENS_JOB_PAGES_MAINNET_REPLACEMENT.md)
Expand All @@ -15,8 +15,8 @@ These files are **additive** to the broader Next.js UI effort in `ui/`; they are

| File | Purpose | Network assumptions | Audience | Status |
| --- | --- | --- | --- | --- |
| `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html` | Standalone, versioned browser interface artifact with live AGIJobManager/ENSJobPages reads and action-capable controls. | Mainnet-focused (`chainId 1`) with embedded contract constants. | Operators, reviewers, demos/audits needing a single-file client. | **Canonical standalone artifact for this repo runbook.** |
| `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v13.html` ... `v42.html` | Earlier standalone snapshots kept for comparison and reproducibility (including prior canonical `v42`). | Mainnet-oriented snapshots. | Auditors/reviewers comparing behavior across versions. | Historical snapshots (non-canonical by default). |
| `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html` | Standalone, versioned browser interface artifact with live AGIJobManager/ENSJobPages reads and action-capable controls. | Mainnet-focused (`chainId 1`) with embedded contract constants. | Operators, reviewers, demos/audits needing a single-file client. | **Canonical standalone artifact for this repo runbook.** |
| `ui/agijobmanager_genesis_job_mainnet_2026-03-05-v13.html` ... `v43.html` | Earlier standalone snapshots kept for comparison and reproducibility (including prior canonical `v43`). | Mainnet-oriented snapshots. | Auditors/reviewers comparing behavior across versions. | Historical snapshots (non-canonical by default). |
| `ui/dist-ipfs/agijobmanager.html` | Generated single-file output from the Next.js/IPFS build pipeline. | Depends on build-time environment/config. | Release operators and distribution maintainers. | Generated artifact. |

## Operator-safe expectations
Expand All @@ -27,12 +27,12 @@ These files are **additive** to the broader Next.js UI effort in `ui/`; they are

## Quick open guidance

For the canonical `v43` artifact:
For the canonical `v44` artifact:

1. Open the runbook: [GENESIS_JOB_MAINNET_HTML_UI.md](./GENESIS_JOB_MAINNET_HTML_UI.md).
2. Prefer local HTTP serving for browser compatibility:
```bash
cd ui
python3 -m http.server 8000
```
3. Open: `http://127.0.0.1:8000/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html`.
3. Open: `http://127.0.0.1:8000/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html`.
14 changes: 7 additions & 7 deletions ui/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This directory contains **two additive UI surfaces**:

1. A modern Next.js app (broader UI effort, still evolving).
2. Versioned standalone HTML artifacts for direct browser use, including:
- `agijobmanager_genesis_job_mainnet_2026-03-05-v43.html`
- `agijobmanager_genesis_job_mainnet_2026-03-05-v44.html`

The standalone HTML page is **not** a replacement for the full UI roadmap.

Expand All @@ -14,22 +14,22 @@ For standalone HTML artifact routing and inventory, see `../docs/ui/STANDALONE_H

## 30-second routing

- Need a **single-file, versioned mainnet interface artifact** for review/operator workflows: use `agijobmanager_genesis_job_mainnet_2026-03-05-v43.html` and the runbook at `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`.
- Need a **single-file, versioned mainnet interface artifact** for review/operator workflows: use `agijobmanager_genesis_job_mainnet_2026-03-05-v44.html` and the runbook at `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`.
- Need to **develop/test the broader UI**: use the Next.js app in this folder and docs at `../docs/ui/README.md`.

## UI inventory (operator-friendly)

| File / path | Purpose | Network / environment | Intended audience | Status | Docs |
| --- | --- | --- | --- | --- | --- |
| `agijobmanager_genesis_job_mainnet_2026-03-05-v43.html` | Standalone browser interface for the Genesis mainnet flow: wallet connect, role/readiness checks, live jobs table, create/apply/validate/dispute/finalize actions, completion submission, and $AGIALPHA bridge/conversion helpers. | Ethereum mainnet-focused (`chainId 1`) with embedded mainnet contract addresses. | Operators, contract-adjacent power users, demos/reviewers who need a single-file interface artifact. | Versioned standalone artifact (additive, active snapshot). | `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md` |
| `agijobmanager_genesis_job_mainnet_2026-03-05-v13.html` ... `v42.html` | Adjacent standalone snapshots for historical comparison and reproducibility (including the prior canonical `v42`). | Mainnet-oriented standalone snapshots. | Auditors/reviewers comparing versions and behavior deltas. | Versioned historical/iterative snapshots (non-canonical by default). | `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md` |
| `agijobmanager_genesis_job_mainnet_2026-03-05-v44.html` | Standalone browser interface for the Genesis mainnet flow: wallet connect, role/readiness checks, live jobs table, create/apply/validate/dispute/finalize actions, completion submission, and $AGIALPHA bridge/conversion helpers. | Ethereum mainnet-focused (`chainId 1`) with embedded mainnet contract addresses. | Operators, contract-adjacent power users, demos/reviewers who need a single-file interface artifact. | Versioned standalone artifact (additive, active snapshot). | `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md` |
| `agijobmanager_genesis_job_mainnet_2026-03-05-v13.html` ... `v43.html` | Adjacent standalone snapshots for historical comparison and reproducibility (including the prior canonical `v43`). | Mainnet-oriented standalone snapshots. | Auditors/reviewers comparing versions and behavior deltas. | Versioned historical/iterative snapshots (non-canonical by default). | `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md` |
| `dist-ipfs/agijobmanager.html` | Built single-file artifact generated from the Next.js UI pipeline (IPFS/distribution output). | Environment depends on build-time config. | Release operators and distribution workflow maintainers. | Generated build output. | `../docs/ui/IPFS_DEPLOYMENT.md` |
| `package.json`, `next.config.*`, `tests/`, `e2e/`, `scripts/` | Full Next.js UI codebase, testing, and deterministic build/documentation tooling. | Local dev/demo + deployment pipelines. | UI developers/operators. | Broader/full UI in development. | `../docs/ui/README.md` |


## Canonical standalone artifact for this runbook

For operator instructions in this repository, `v43` is the explicit standalone artifact documented in:
For operator instructions in this repository, `v44` is the explicit standalone artifact documented in:

- `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`
- `../docs/ui/STANDALONE_HTML_UIS.md`
Expand All @@ -50,7 +50,7 @@ Open the dedicated runbook first:
- `../docs/ui/GENESIS_JOB_MAINNET_HTML_UI.md`

Recommended operator posture:
- Treat `v43` as a versioned mainnet snapshot with embedded addresses.
- Treat `v44` as a versioned mainnet snapshot with embedded addresses.
- Verify network + addresses in the runbook before signing wallet transactions.
- Use the broader Next.js UI docs for roadmap/development workflows.

Expand All @@ -76,7 +76,7 @@ python3 -m http.server 8000
Open:

```text
http://127.0.0.1:8000/agijobmanager_genesis_job_mainnet_2026-03-05-v43.html
http://127.0.0.1:8000/agijobmanager_genesis_job_mainnet_2026-03-05-v44.html
```

Pre-sign trust check (recommended):
Expand Down
Loading
Loading