Skip to content
Merged
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
41 changes: 41 additions & 0 deletions docs/deployments.md
Original file line number Diff line number Diff line change
Expand Up @@ -946,3 +946,44 @@ Until it executes, both contracts still accept `request_advance` and `verify_and
the borrower's authorisation**. On testnet, where every proof in existence is signed by a key
published in this repository, the only creator who could be harmed by that is us — but it is the
live state and it is stated rather than implied.

---

## #22 — the creator front end, public (2026-10-23)

**<https://app.forepay.xyz>** serves `fe/` from `main`, on testnet, with no login.

| | |
| --- | --- |
| Host | Vercel, project `forepay-vue5` in @AncungAulia's team, root directory `fe`. Each merge to `main` that touches `fe/` redeploys it |
| Deployed commit | `9b81d82` (#71 merged). `9538cf4` after it touched only `landing-page/`, and Vercel skipped it as not affected |
| Domain | `app.forepay.xyz`, a CNAME to Vercel at the domain's DNS |
| Contract | `NEXT_PUBLIC_ADVANCE_CONTRACT_ID` = `CCQFL2Q66DHFAZU2KPRWNHU4FTZJW75N5XLNXECFFGMW3PROIXJPI2HS`, the production contract above |
| USDC | `CBIELTK6YBZJU5UP2WWQEUCYKLPU6AUNZ2BQ4WWFEIE3USCIHMXQDAMA`, `USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5` |
| RPC | `https://soroban-testnet.stellar.org` |
| API | `https://api-forepay.jameshub.fun` (#16) |
| Not set | `NEXT_PUBLIC_RELAY_URL` and `NEXT_PUBLIC_GOOGLE_CLIENT_ID` (the relay client is #75, not merged), `NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID`, `NEXT_PUBLIC_E2E` |

Checked by the rendered page, not by a status code (#22):

- In Chrome, with a Freighter testnet wallet connected: the onboarding step that asks an unfunded
wallet for test XLM; then, once the wallet was funded and allowed USDC, 2a "Get an advance" with
the wallet card (Freighter, Stellar testnet, "Can receive USDC: Yes") and the rule read from the
contract ("A quarter of your proven revenue, up to 100 USDC"); Repayment and History reading
"No advance yet" from the API. No console errors.
- In headless Chromium, with no wallet, at 1440 and 390: "Before you start", "Connect your wallet",
and "Install a Stellar wallet" after pressing Connect wallet. No console errors.
- The API answers the deployed origin: `GET /config` with `Origin: https://app.forepay.xyz` returns
`access-control-allow-origin: https://app.forepay.xyz`, as does the preflight. The `CORS` row of
the #16 / #17 entry above is no longer only `localhost`.

The screenshots are in [`docs/evidence/`](evidence/).

### What is not claimed yet

- **Proving revenue does not reach the offer on this deployment.** With `NEXT_PUBLIC_RELAY_URL`
empty, 2a proves against the mock in `fe/src/lib/reclaim/mock.ts`, and the contract refuses its
proofs. No screenshot of the offer, signing, a sent advance or a repayment is taken from it.
The relay client is #75; a real proof also needs a `READY` AdSense account with revenue (#77).
- **WalletConnect is off.** Without a project ID, only the browser extensions (Freighter, xBull,
Rabet) are offered, although "Connect your wallet" mentions mobile wallets through WalletConnect.
44 changes: 32 additions & 12 deletions docs/evidence.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,20 +112,39 @@ contract, or read the [five funding transactions](deployments.md).
| Prove revenue, see the offer with its derivation, accept | **Merged** — [#57](https://github.com/forepay-stellar/forepay/pull/57) |
| Repayment and history, read from the ledger | **Merged** — [#58](https://github.com/forepay-stellar/forepay/pull/58) |
| Backend the screens read from | **Merged and live** — <https://api-forepay.jameshub.fun/health> ([API reference](api.md)) |
| **Live demo link** | ⏳ [#22](https://github.com/forepay-stellar/forepay/issues/22) |
| **Screenshots** | ⏳ [#22](https://github.com/forepay-stellar/forepay/issues/22) |
| **Live demo link** | **Live** — <https://app.forepay.xyz>, testnet, no login (how it was checked: the #22 entry in [deployments.md](deployments.md)) |
| **Screenshots** | Taken from the live app — see below |

The offer screen does not hard-code the 25% rate or the 100 USDC cap. It reads them from the
contract, so the derivation shown next to the figure is the arithmetic that produced it.

### Screenshots, from the live app

Every screenshot here is of <https://app.forepay.xyz> on 2026-10-23. None comes from a local or
mocked build.

| Step | Desktop | Phone |
| --- | --- | --- |
| Before you start | [1a](evidence/1a-before-you-start-desktop.png) | [1a](evidence/1a-before-you-start-mobile.png) |
| Connect your wallet | [1b](evidence/1b-connect-wallet-desktop.png) | [1b](evidence/1b-connect-wallet-mobile.png) |
| No wallet installed | [1b](evidence/1b-no-wallet-installed-desktop.png) | [1b](evidence/1b-no-wallet-installed-mobile.png) |
| An unfunded wallet is asked for test XLM | [1c](evidence/1c-add-test-xlm-desktop.jpg) | |
| Prove revenue: wallet allowed USDC, rule read from the contract | [2a](evidence/2a-prove-revenue-desktop.jpg) | |
| Repayment, before the first advance | [3a](evidence/3a-repayment-no-advance-desktop.jpg) | |
| History, before the first advance | [3b](evidence/3b-history-no-advance-desktop.jpg) | |

> #### What Deliverable 2 does not show yet
>
> **This row is not ready to tick.** The screens are written, reviewed and merged, and the API they
> read is live — but there is no deployed URL to click and no screenshots yet. Until
> [#22](https://github.com/forepay-stellar/forepay/issues/22) lands, this row is honestly **Partial**.
> **The flow stops at “prove revenue” on the live app.** The screens after it — the offer with its
> derivation, signing, the advance arriving, a repayment — are written, reviewed and merged, but
> there is no screenshot of them, because none could be taken honestly yet:
>
> - the live app is not yet connected to the proof relay; that client is
> [#75](https://github.com/forepay-stellar/forepay/pull/75), in review;
> - and a real proof needs an AdSense account with revenue, which is Deliverable 1's open gap
> ([#77](https://github.com/forepay-stellar/forepay/issues/77)).
>
> It also cannot complete end to end in a browser until Deliverable 1's missing piece arrives: the
> flow stops at “prove revenue” without a real AdSense account.
> Until both land, this row is honestly **Partial**: live, but not end to end.

---

Expand Down Expand Up @@ -233,13 +252,14 @@ simulated.
| | |
| --- | --- |
| **Deliverable 1** | **Present**, with one stated gap: no advance against a real AdSense proof yet (#77) |
| **Deliverable 2** | **Partial** — screens merged and the API live, no deployed URL or screenshots yet (#22) |
| **Deliverable 2** | **Partial** — live at <https://app.forepay.xyz> with screenshots; the flow stops at “prove revenue” until the relay client (#75) and a real proof (#77) land |
| **Deliverable 3** | **Partial** — transaction evidence and all three negative cases done; video outstanding (#28) |

We would rather hand you this table than have you discover it. The two Partials are both work that
exists and is not yet published; the gap in Deliverable 1 is an external dependency on a Google
account, and [#77](https://github.com/forepay-stellar/forepay/issues/77) explains what would close
it and what the alternative is if it does not arrive.
We would rather hand you this table than have you discover it. Deliverable 3's Partial is work that
exists and is not yet published (the video). Deliverable 1's gap, and what still keeps Deliverable 2
from end to end, is the same external dependency on a Google account:
[#77](https://github.com/forepay-stellar/forepay/issues/77) explains what would close it and what
the alternative is if it does not arrive.

## Everything else, if you want to go deeper

Expand Down
Binary file added docs/evidence/1a-before-you-start-desktop.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/1a-before-you-start-mobile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/1b-connect-wallet-desktop.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/1b-connect-wallet-mobile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/1b-no-wallet-installed-desktop.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/1b-no-wallet-installed-mobile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/1c-add-test-xlm-desktop.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/2a-prove-revenue-desktop.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/3a-repayment-no-advance-desktop.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/evidence/3b-history-no-advance-desktop.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.