Align Celo credit ingestion with idempotent funding, minimum USD thresholds, and outstanding credit handling

[Copilot]

This updates credit issuance to match the new operator-vault flow: credits are recorded per deposit/stream event with stable IDs, funding is idempotent, and failures are tracked as outstanding balances instead of losing user credit intent. It also enforces $1-equivalent minimums in the Celo vault for first deposits and monthly stream rates using reserve-priced G$ valuation.

• Backend funding path: depositForWithId + deterministic IDs

  • Switched buyer funding from depositFor to depositForWithId.
  • Uses txHash:logIndex for on-chain events, with controlled fallback IDs for manual/event edge paths.
  • Persists funding metadata per credit entry (fundingStatus, fundingId, fundingTxHash, fundingError).

• Outstanding credit accounting + credit history completeness

  • Credit entries are always recorded, including tx hash/log index context when present.
  • Added profile-level outstanding funding aggregate and principal-withdrawn tracking.
  • Funding failures are retained as outstanding credits rather than dropped/reverted business intent.
  • Added outstanding stream-bonus aggregate tracking in profile state.

• New user-facing backend endpoints

  • GET /v1/accounts/:account/outstanding for unpaid funding/outstanding balances.
  • POST /v1/accounts/:account/withdraw with principal-only withdrawal enforcement (bonus non-withdrawable).
  • POST /v1/channels/close to request channel close/unlock via operator integration.
  • Extended POST /v1/celo/events/record to support either single-transaction ingestion (txHash) or wallet-scoped log scans (account + block range).

• Stream bonus settlement lifecycle (monthly + on stop/update)

  • Added stream state tracking (active, lastBonusPaidAt) and indexed tracked streams.
  • Added proportional stream bonus settlement when flow is updated/stopped.
  • Added scheduled monthly settlement of active streams via Worker cron (* * * * *) with idempotent funding IDs (stream:<timestamp>:<account>).

• Operator contract: idempotent funding primitive

  • Added AntseedBuyerOperator.depositForWithId(...).
  • Added duplicate-ID guard (usedDepositIds) and dedicated event for ID-based funding.

• Celo vault constraints for new economics

  • Enforced minimum first deposit of $1 equivalent.
  • Enforced minimum monthly stream flow speed of $1 equivalent.
  • Added reserve-price oracle config/fallback and sanity bounds for price input used in USD conversion.

// Worker funding call now uses idempotent ID-based deposit
const depositId = `${event.txHash}:${event.logIndex}`;
const bridge = await antseedFundingVault.depositForBuyerWithId(
  event.account,
  BigInt(entry.totalCreditMicroUsd),
  depositId
);
await store.markFundingResult(entry.id, { funded: true, id: depositId, txHash: bridge.txHash });

[sirpy]

@copilot
Use the following skills gooddollar/goodskills and superfluid-org/skills

1. review the code and make sure the 10 bullet points from the original issue where addressed.
2. the getting price from the reserve logic is incorrect use the skil from gooddollar/goodskills
3. user the superfluid-org skill and goodskills to verify things related to superfluid and streaming

[Copilot]

@copilot
Use the following skills gooddollar/goodskills and superfluid-org/skills

1. review the code and make sure the 10 bullet points from the original issue where addressed.
   ...

Addressed in b4d3938. I reviewed the issue checklist against this PR and fixed the reserve-price path to read GoodDollar reserve currentPriceDAI() (converted to micro-USD) for min first-deposit and min monthly-stream checks, while keeping compatibility with gdMicroUsdPerToken() adapters. I also added Superfluid-related vault tests to verify stream minimum enforcement and deposit minimum behavior under reserve-priced values.

[sirpy]

@copilot
Use the following skills gooddollar/goodskills and superfluid-org/skills
many of the original issue bullet points are not done.
for each bullet point report where and how it is implemented.
if it is not implemented then implement.
make sure in your final comment to report where and how each of the 10 bullet points is implemented

[Copilot]

@copilot
Use the following skills gooddollar/goodskills and superfluid-org/skills
many of the original issue bullet points are not done.
...

Addressed in 3c2398e (plus earlier PR commits). Mapping to the 10 issue bullets:

1. Min first deposit = $1
   contracts/src/CeloGdAntSeedVault.sol:56,145,256 (+ reserve pricing in :292-309).

2. Min monthly stream rate = $1
   contracts/src/CeloGdAntSeedVault.sol:57,274 (+ reserve pricing in :292-309).

3. depositForWithId + duplicate-ID prevention in operator
   contracts/src/AntseedBuyerOperator.sol:22,100-110 (guard/event). Tested in contracts/test/AntseedBuyerOperator.t.sol:193-197.

4. Backend notify endpoint for Celo deposit/stream; use depositForWithId with txHash:logIndex
backend/src/worker.ts:113-152,176-187,282-285.

5. Event checking every minute OR by wallet-triggered endpoint
   Minute cron: backend/wrangler.toml:24-25, backend/src/worker.ts:49-61.
   Wallet-triggered scan: backend/src/worker.ts:113-120, backend/src/celo-events.ts:54-75.

6. Deposits credit immediately (+10%); funding failure becomes outstanding owed credit
   Credit issuance: backend/src/kv-credit-store.ts:209-267.
   Funding success/failure handling: backend/src/worker.ts:134-143,183-187 + backend/src/kv-credit-store.ts:269-291.

7. Stream bonus (20%) paid monthly or on stop/update; track active/last paid
   Flow-change settlement: backend/src/kv-credit-store.ts:151-182, called in backend/src/worker.ts:206-214.
   Periodic monthly settlement: backend/src/kv-credit-store.ts:184-205, scheduled via backend/src/worker.ts:49-61.
   State tracking: backend/src/types.ts:65-75, backend/src/kv-credit-store.ts:133-135.

8. Outstanding endpoint for failed deposit funding + outstanding streaming bonus
   backend/src/worker.ts:227-241 and profile accounting in backend/src/kv-credit-store.ts:428-430,477.

9. Withdraw endpoint; principal only (bonus non-withdrawable)
   Endpoint: backend/src/worker.ts:244-254.
   Principal-only enforcement: backend/src/kv-credit-store.ts:295-317.

10. Channel close/unlock request endpoint
    backend/src/worker.ts:256-262 + bridge call in backend/src/antseed-funding-vault.ts:67-72.

Validation run after changes: backend lint/test/build all passing; parallel validation (Code Review + CodeQL) rerun with no security alerts.