Skip to content

docs: README for judges: six tracks, NEAR Intents, the proof behind the badge, Q-015 - #283

Merged
Lexirieru merged 6 commits into
mainfrom
docs/readme-judges-12nov
Nov 12, 2026
Merged

Lexirieru merged 6 commits into
mainfrom
docs/readme-judges-12nov

Conversation

@Lexirieru

Copy link
Copy Markdown
Contributor

README update for the judges and the AI screening (HACKATHON.md: "what the product is, the problem it solves, and how to try it as do X, see Y").

Changes

Checked

  • Every on-chain link the README cites was re-read on the archival testnet RPC today:
    • AKYYpkLq…: Transfer from the demo wallet, success;
    • the registry deploy ESMY36Uo… and equip_skill 6diDXaAY…: success;
    • the registry reports v0.3.0, NEP-330.
  • The TEE Explorer report link opens and reads VERIFIED.
  • No em/en dashes.
  • Not verified on the hosted demo: the paid-data step needs SHOP_PAY_TO on the hosted backend. @Lin1er, is it set?

🤖 Generated with Claude Code

…f, Q-015

- Tracks: the six we submit to (security, privacy, agents, swarms, business,
  realworld), each with a do-this-see-that step.
- How NEAR is used: NEAR Intents 1Click quotes signed by 1Click and checked
  with the official SDK; the proof behind the badge and Phala's TEE Explorer,
  with a real report link.
- Try it: a cross-chain quote and the proof routes.
- Libraries and services; Q-015 section (Ancung is also in Waybil, #22).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
Testnet so judges try it free, the try-out (guest) mode, NEAR AI credits paid
by the team; after the hackathon: mainnet, pay-as-you-go AI credits, more
Mind templates (Axel, 12 Nov). Marked as planned, not built.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
@Lexirieru

Copy link
Copy Markdown
Contributor Author

Added "Now and after the hackathon" (Axel's words, marked as planned, not built):

  • Now: NEAR testnet so judges try it for free, the try-out (guest) mode, and NEAR AI Cloud credits paid by the team.
  • After: mainnet (cross-chain stablecoin payments through NEAR Intents then sendable), pay-as-you-go AI credits topped up by owners (each run already records its tokens and cost), more Mind templates.

Lexirieru and others added 3 commits November 12, 2026 22:54
Rewritten for judges and the AI screening, without development notes:
- header with links that are live now, the three Mind characters;
- a per-track table quoting the Build and Hints text of HACKATHON.md, what
  HelloNear built for each of the six tracks, the skills and a check step;
- connectors with the web app's own logos (rendered to SVG from
  AppLogos.tsx into docs/readme/icons), and the skills with the icons the
  Skills screen shows;
- receipts: testnet transactions re-read on the archival RPC, the TEE
  Explorer report, the NEAR Intents signature check;
- the Mastra agent in detail: design, all 50 tools (approval, what each
  calls), all 33 skills (from the engine's catalog), how it is tested;
- limits, the plan after the hackathon, team, Q-015.
No emoji.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
…equest named plainly

A table of every technology with the files that use it and what it does
(NEAR, NEAR AI Cloud, NEAR Intents, OutLayer, Meteor/NEAR Connect, FastNear,
Phala, Mastra, the models, Composio, AgentMail, Telegram, Postgres, the web
stack, the contract stack, hosting). Black logos get white variants for
GitHub's dark theme (<picture>). "Other apps" is now HTTP request.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
@Lin1er

Lin1er commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

@Lexirieru one fact in the tech stack table: the FastNear row lists apps/be/src/config.ts, but on main the backend still defaults to https://rpc.testnet.near.org (config.ts:36). #278 moved only the engine. The backend uses that URL for NEP-413 sign-in (access keys), the wallet view and the shop's tx check.

I've pushed the fix on branch fix/be-fastnear-rpc (2f34f0a): it makes https://test.rpc.fastnear.com the backend default (NEAR_RPC_URL still overrides it), and updates .env.example and apps/be/CLAUDE.md.

  • apps/be typecheck passes; bun run test 134/134 (1 opt-in skipped); bun run load 0 errors.
  • FastNear answers view_account, view_access_key_list and gas_price (checked by hand).
  • The hosted backend logged no "deprecated" errors today, so this is a precaution before judging, not an outage.

OK to open a PR to main for it? With it merged, the README row is right as written.

- docs/openapi.json: the 60 public operations, with auth, request bodies,
  answers and server-sent event responses.
- README: an API reference section built from it; 34 endpoints were called
  against the hosted API with a guest session on 12 Nov and answered as
  documented (chat with a cross-chain quote, proof, TEE Explorer, approval
  then decline with nothing paid, workflows, an attack run), marked in the
  table.
- "Continue as guest" and "guest" to match the app (#284); the hackathon
  phase note (testnet, free for judges, AI credits from the team) under Try it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e
@Lexirieru

Copy link
Copy Markdown
Contributor Author

Merged with Axel's approval; main deploys after its CI. The README is now the judges' version: six tracks with the organizers' wording quoted, connectors and skills with the app's icons, receipts, the Mastra agent with all 50 tools and 33 skills, a tech stack table, and an API reference (docs/openapi.json, 34 endpoints checked live on the hosted API). @Lin1er @Nabil-Aufa: if either of you is in another NEAR HACKATHON project, post it on #22 so the Q-015 section names it.

@Lin1er

Lin1er commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Live on the hosted demo: first in main 80b346f (automatic deploy after the merge), and now d54bed3.

  • GET /v1/health → {"ok":true,"engine":true,"revision":"d54bed3"}; be, engine, fe and landing active, no backend HTTP errors since the deploy.
  • app.hellonear.xyz, api.hellonear.xyz/v1/health and hellonear.xyz answer 200; the guest try-out e2e passed 22/22.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants