SYS.DOCS // END_TO_END_PROTOCOL_SPEC

HOW_IT_WORKS

VISUAL_WORKFLOW

STEP_01

Maintainer Logs in & Connects Repo

STEP_02

Install GitHub App on Repo

STEP_03

Deploy Multi-Release Escrow (On-Chain)

STEP_04

Label Issue (Low/Med/High/Custom)

STEP_05

Bot Comments & Asks for Wallet

STEP_06

Contributor Links Stellar Wallet

STEP_07

Milestone Created On-Chain

FINAL_EXECUTION

PR Merged → Instant Payout

MAINTAINER_POV

01_SETUP:
Log in with GitHub. In your dashboard, click "Connect Repo" to authorize our GitHub App on your chosen repositories.
02_INFRASTRUCTURE:
Navigate to the repo in our DApp and click DEPLOY_ESCROW. This deploys a multi-release smart contract on Stellar. You will need to sign this with a Stellar wallet (e.g., Albedo/Freighter).
03_BOUNTY_ASSIGNMENT:
Go to your GitHub issue and add one of these labels:
low
medium
high
custom
04_CUSTOM_AMOUNTS:
If you use the 'custom' label, simply comment on the issue:
@trustless-oss-bot 150
The bot will update the milestone in our database immediately.
05_LIQUIDITY_MANAGEMENT:
Need your funds back? Use the REFUND_FUNDS button in your dashboard. This generates an on-chain transaction to pull USDC from the escrow back to your wallet.

CONTRIBUTOR_POV

01_REGISTRATION:
Once assigned to a labeled issue, the bot will post a link. Click it to connect your Stellar wallet.
02_ON_CHAIN_SYNC:
As soon as your wallet is linked, the DApp creates a milestone **on-chain** inside the repo's escrow. Your payment is now cryptographically secured.
03_PAYOUT:
Open your PR. When the maintainer merges it, our protocol detects the event and **instantly** releases the USDC funds from the escrow to your wallet.
04_HELP_COMMANDS:
Need to change your address or see status? Comment:
@trustless-oss-bot /help
Follow the prompts to update your configuration.

SECURE_TRANSPARENT_AUTOMATED