@marigoldlabs/web3-tester 0.1.2 → 0.4.2

package/docs/CONSUMING_FROM_FJORD.md

@@ -1,123 +0,0 @@
-# Consuming Web3 Tester From Fjord V4
-
-This guide covers adding the published package to Fjord v4 as a dependency.
-
-## Install
-
-```bash
-npm install --save-dev @marigoldlabs/web3-tester
-```
-
-For a pinned dependency, use an exact package version:
-
-```bash
-npm install --save-dev @marigoldlabs/web3-tester@<version>
-```
-
-## Playwright Config
-
-Use Fjord's existing Playwright config if it already exists. The important parts are:
-
-```ts
-import { defineConfig, devices } from '@playwright/test';
-
-export default defineConfig({
-  fullyParallel: true,
-  retries: process.env.CI ? 2 : 0,
-  use: {
-    baseURL: process.env.DAPP_URL ?? 'http://localhost:3000',
-    trace: 'on-first-retry',
-  },
-  projects: [
-    {
-      name: 'chromium',
-      use: { ...devices['Desktop Chrome'] },
-    },
-  ],
-});
-```
-
-## Local Deterministic Tests
-
-```ts
-import { expect, test } from '@marigoldlabs/web3-tester/fixtures';
-
-test('connects through the injected provider', async ({ page, wallet }) => {
-  await page.goto('/');
-
-  await page.getByRole('button', { name: /connect wallet/i }).click();
-  await page.getByText('Mock Wallet').click();
-
-  await expect(page.getByText(wallet.primaryAccount.slice(0, 6))).toBeVisible();
-});
-```
-
-## Test Options
-
-Customize provider identity for wallet selector coverage:
-
-```ts
-test.use({
-  walletOptions: {
-    providerInfo: { name: 'MetaMask', rdns: 'io.metamask' },
-    additionalProviders: [
-      { name: 'Rabby', rdns: 'io.rabby' },
-      { name: 'Rainbow', rdns: 'me.rainbow' },
-    ],
-  },
-});
-```
-
-Customize Anvil:
-
-```ts
-test.use({
-  anvilOptions: {
-    runtime: 'docker',
-    chainId: 31337,
-    forkUrl: process.env.ANVIL_FORK_URL,
-  },
-});
-```
-
-## Live Sepolia Tests
-
-```ts
-import { expect, test } from '@marigoldlabs/web3-tester/live-fixtures';
-
-test.skip(!process.env.FJORD_PRIVATE_KEY, 'FJORD_PRIVATE_KEY is required.');
-
-test('loads the Sepolia account', async ({ page, wallet }) => {
-  await page.goto('/');
-  await expect(page.getByText(wallet.primaryAccount.slice(0, 6))).toBeVisible();
-});
-```
-
-Run with:
-
-```powershell
-$env:FJORD_PRIVATE_KEY = '<runtime-only-key>'
-$env:SEPOLIA_RPC_URL = '<optional-rpc-url>'
-npm test
-```
-
-## Mutation Gates
-
-Use explicit flags for anything that spends funds or mutates backend state:
-
-```powershell
-$env:FJORD_RUN_TRANSACTIONS = 'true'
-$env:FJORD_MUTATE_STATE = 'true'
-$env:FJORD_PUBLISH_SALES = 'true'
-$env:FJORD_ADMIN_MUTATE = 'true'
-```
-
-Keep destructive or expensive tests behind separate flags so normal CI remains read-only.
-
-## CI Recommendations
-
-- Run deterministic Anvil tests on every PR.
-- Run live Sepolia read-only tests on a scheduled job or protected branch.
-- Run live mutation tests manually with approval.
-- Store `FJORD_PRIVATE_KEY` and `SEPOLIA_RPC_URL` only as CI secrets.
-- Pin the npm dependency to an exact version once Fjord depends on it.

package/docs/FJORD_LIVE_QA.md

@@ -1,87 +0,0 @@
-# Fjord V4 Live QA
-
-The Fjord QA specs in `tests/fjord*.spec.ts` are the working executable version of the manual QA document.
-
-Target:
-
-```text
-https://v4.fjordfoundry.com
-```
-
-Network:
-
-```text
-Sepolia
-```
-
-Any legacy "mainnet" wording in the manual QA doc is treated as Sepolia for this test harness.
-
-## Test Categories
-
-| Category | Specs | Default behavior |
-| --- | --- | --- |
-| Public read-only | `fjord-public`, `fjord`, public parts of other specs | Runs without private key where possible. |
-| Live wallet read-only | `fjord-live-sepolia`, `fjord-auth-edge`, `fjord-partials-live` | Requires `FJORD_PRIVATE_KEY`. |
-| Live transaction | `fjord-live-transaction` | Requires `FJORD_RUN_TRANSACTIONS=true`. |
-| Live mutations | `fjord-live-mutations` | Requires `FJORD_MUTATE_STATE=true`. |
-| Sale publishing | `fjord-live-mutations` publish branch | Requires `FJORD_PUBLISH_SALES=true`. |
-| Admin mutations | `fjord-admin-mutations` | Requires `FJORD_ADMIN_MUTATE=true`. |
-
-## Read-Only Run
-
-```powershell
-$env:FJORD_PRIVATE_KEY = '<runtime-only-key>'
-$env:DAPP_URL = 'https://v4.fjordfoundry.com'
-npm test -- --reporter=list tests/fjord-public.spec.ts tests/fjord-live-sepolia.spec.ts tests/fjord-auth-edge.spec.ts tests/fjord-partials-live.spec.ts
-```
-
-## Live Mutation Run
-
-```powershell
-$env:FJORD_PRIVATE_KEY = '<runtime-only-key>'
-$env:DAPP_URL = 'https://v4.fjordfoundry.com'
-$env:FJORD_MUTATE_STATE = 'true'
-$env:FJORD_QA_RUN_ID = 'YYYYMMDDXX'
-npm test -- --reporter=list tests/fjord-live-mutations.spec.ts
-```
-
-## Sale Publish Attempt
-
-```powershell
-$env:FJORD_PRIVATE_KEY = '<runtime-only-key>'
-$env:FJORD_MUTATE_STATE = 'true'
-$env:FJORD_PUBLISH_SALES = 'true'
-$env:FJORD_QA_RUN_ID = 'YYYYMMDDPX'
-npm test -- --reporter=list tests/fjord-live-mutations.spec.ts
-```
-
-## Admin Mutation Attempt
-
-```powershell
-$env:FJORD_PRIVATE_KEY = '<runtime-only-key>'
-$env:FJORD_ADMIN_MUTATE = 'true'
-npm test -- --reporter=list tests/fjord-admin-mutations.spec.ts
-```
-
-## Reporting Rules
-
-- Record `PASS`, `FAIL`, `PARTIAL`, `BLOCKED`, `NOT RUN`, or `N/A` for every doc line.
-- When a line fails, note the observable behavior and continue to the next line.
-- Do not collapse a doc mismatch into a product failure if the live UI has moved the control.
-- Never paste private keys into reports.
-- Include transaction hashes and deployed QA addresses when they help debugging.
-
-## Current Report Artifacts
-
-- `reports/fjord-full-line-by-line-qa-2026-05-14.md`
-- `reports/fjord-qa-results-2026-05-14.md`
-
-## Known Findings From The 2026-05-14 Run
-
-- ERC-20 deployment from the Fjord UI succeeded.
-- Token supply input minted raw units rather than the expected human-token amount.
-- Fixed-price sale draft creation reached review.
-- The review step did not show the documented full sale summary.
-- Publishing submitted an ERC-20 approval transaction but did not continue to pool creation.
-- Saved QA drafts were not listed in the resume dialog.
-- `/admin/cache` failed loading admin data with backend `401`.

package/docs/RELEASE_CHECKLIST.md

@@ -1,55 +0,0 @@
-# Release Checklist
-
-Use this before publishing a new version or pinning it inside Fjord v4.
-
-## Required
-
-- `npm run typecheck`
-- `npm run build`
-- `npm test`
-- `rg -n "FJORD_PRIVATE_KEY\\s*=\\s*0x[0-9a-fA-F]{64}|PRIVATE_KEY=.*[0-9a-fA-F]{64}" . -g "!node_modules/**" -g "!dist/**" -g "!.npm-cache/**"`
-- Confirm `.env` is ignored.
-- Confirm `dist/` is generated locally but not required in source review unless the team wants committed build output.
-
-## Dependency Consumer Check
-
-From a clean consumer repo:
-
-```bash
-npm install --save-dev @marigoldlabs/web3-tester@<version>
-```
-
-Then import:
-
-```ts
-import { expect, test } from '@marigoldlabs/web3-tester/fixtures';
-```
-
-Run one provider smoke test.
-
-## Live QA Check
-
-Run live tests only with runtime secrets:
-
-```powershell
-$env:FJORD_PRIVATE_KEY = '<runtime-only-key>'
-$env:DAPP_URL = 'https://v4.fjordfoundry.com'
-npm test -- --reporter=list tests/fjord-live-sepolia.spec.ts
-```
-
-Mutation runs require explicit flags and should not be part of default CI.
-
-## Push
-
-```bash
-git status --short
-git add .
-git commit -m "Document and package Web3 tester"
-git push -u origin main
-```
-
-## Publish
-
-```bash
-npm publish --access public
-```