From 66e6960559dbf746df6ce5c68bfda1903a8213f1 Mon Sep 17 00:00:00 2001 From: k3dz0r Date: Mon, 24 Nov 2025 09:29:58 -0300 Subject: [PATCH 1/5] Minor changes --- docs/cli/Guides/collaboration.md | 4 ++-- docs/cli/Guides/confidential-fine-tuning.md | 20 +++++++++---------- docs/cli/Guides/provider-tools.md | 2 +- docs/data-for-ai/Overview/about.md | 16 +++++++-------- docs/data-for-ai/Overview/dates.md | 2 +- docs/data-for-ai/Overview/support.md | 4 ++-- docs/data-for-ai/Rules/referrals.md | 8 ++++---- docs/data-for-ai/Rules/rewards.md | 8 ++++---- .../deployment_guides/tunnels/repo.md | 2 +- .../developers/marketplace_gui/walkthrough.md | 6 +++--- docs/hackathon/about.md | 6 +++--- docs/hackathon/liquity.md | 2 +- docs/hackathon/rules.md | 4 ++-- docs/hackathon/venus-protocol.md | 2 +- docs/whitepaper/abstract.md | 2 +- docs/whitepaper/blockchain-solution.md | 6 +++--- docs/whitepaper/high-level-description.md | 2 +- docs/whitepaper/target-audience.md | 2 +- 18 files changed, 49 insertions(+), 49 deletions(-) diff --git a/docs/cli/Guides/collaboration.md b/docs/cli/Guides/collaboration.md index 101a0842..100835d3 100644 --- a/docs/cli/Guides/collaboration.md +++ b/docs/cli/Guides/collaboration.md @@ -8,13 +8,13 @@ unlisted: true Super Protocol enables independent parties to jointly compute over their private inputs without revealing those inputs to one another. -This guide describes a simple example of confidential collaboration between two parties, **Alice** and **Bob**. Alice owns a script she wants to use to process Bob's dataset. +This guide describes an example of confidential collaboration between two parties, **Alice** and **Bob**. Alice owns a script she wants to use to process Bob's dataset. The dataset contains sensitive information and cannot be shared. At the same time, Bob must review the script to ensure it is safe to run on his data. If Alice's script is proprietary and she cannot share it with Bob, a possible alternative is to involve independent security experts who can audit the script without exposing it publicly. The computation runs on Super Protocol within a Trusted Execution Environment that is isolated from all external access, including that of Alice, Bob, the hardware owner, and the Super Protocol team. Additionally, Super Protocol's Certification System ensures verifiability, eliminating the need for trust. -The following is just one example of confidential collaboration. Super Protocol's architecture enables a range of more complex scenarios involving multiple parties and assets. +The following is just one relatively simple example of confidential collaboration. Super Protocol's architecture enables a range of more complex scenarios involving multiple parties and assets. ## General workflow diff --git a/docs/cli/Guides/confidential-fine-tuning.md b/docs/cli/Guides/confidential-fine-tuning.md index 5b7d9ac7..b67708ed 100644 --- a/docs/cli/Guides/confidential-fine-tuning.md +++ b/docs/cli/Guides/confidential-fine-tuning.md @@ -64,7 +64,7 @@ sequenceDiagram ```
-Alice uploads her model ([6](/cli/guides/fine-tune#alice-6-upload-the-model)) and Bob uploads his dataset ([7](/cli/guides/fine-tune#bob-7-upload-the-dataset)) to remote storage using SPCTL. The dataset is automatically encrypted during upload, and only Bob holds the key. +Alice uploads her model ([6](/cli/guides/fine-tune#alice-6-upload-the-model)) and Bob uploads his dataset ([7](/cli/guides/fine-tune#bob-7-upload-the-dataset)) to remote storage using SPCTL. Files are automatically encrypted during upload, and only the uploader holds the key. Bob creates an offer on the Marketplace ([8](/cli/guides/fine-tune#bob-8-create-an-offer)). The offer requires Bob's manual approval for use. He shares the offer's IDs with Alice. @@ -179,15 +179,15 @@ If you did not include training scripts in the image, upload them separately: Replace `` with the path to the directory containing your training scripts. -### Carol: 3. Send the solution to Alice and Bob +:::important -Send the output resource files from the previous step to Alice and Bob (or independent auditors). +The output resource files contain information needed to access and decrypt the uploaded files. Be careful with sharing resource files if the uploaded content is sensitive. -:::warning +::: -Although SPCTL encrypts data during upload, the output resource files contain information on how to access and decrypt it. +### Carol: 3. Send the solution to Alice and Bob -::: +Send the output resource files from the previous step to Alice and Bob (or independent auditors). ### Alice and Bob: 4. Download the solution @@ -324,7 +324,7 @@ Provide Alice with these IDs. Ignore other instructions you see in the output. --solution ./solution.resource.json \ --data ./model.resource.json \ --data , \ - --tee + --tee \ [--data ./scripts.resource.json] ``` @@ -403,9 +403,9 @@ Additionally, find entries in the `runtimeInfo` array that start with `"type": " "type": "Data", "size": 12901, "hash": { - "algo": "sha256", - "hash": "8598805cd2136a4beff17559a7228854f6a8cc0b027856ea5c196fb8d0602501", - "encoding": "hex" + "algo": "sha256", + "hash": "8598805cd2136a4beff17559a7228854f6a8cc0b027856ea5c196fb8d0602501", + "encoding": "hex" } }, ``` diff --git a/docs/cli/Guides/provider-tools.md b/docs/cli/Guides/provider-tools.md index d041a00e..b6cd6b72 100644 --- a/docs/cli/Guides/provider-tools.md +++ b/docs/cli/Guides/provider-tools.md @@ -1,6 +1,6 @@ --- id: "provider-tools" -title: "Set Up Provider Tools" +title: "Configure Provider Tools" slug: "/guides/provider-tools" sidebar_position: 1 --- diff --git a/docs/data-for-ai/Overview/about.md b/docs/data-for-ai/Overview/about.md index 2ee25347..0471cf17 100644 --- a/docs/data-for-ai/Overview/about.md +++ b/docs/data-for-ai/Overview/about.md @@ -5,7 +5,7 @@ slug: "/overview/about" sidebar_position: 1 --- -The Super Protocol Data-for-AI Campaign is more than a contest—it’s a collaborative initiative to rethink how AI systems are trained in high-stakes, regulated domains. By sourcing high-quality, publicly available regulatory and clinical data, we aim to make AI development transparent, decentralized, and verifiable from the ground up. +The Super Protocol Data-for-AI Campaign is more than a contest—it's a collaborative initiative to rethink how AI systems are trained in high-stakes, regulated domains. By sourcing high-quality, publicly available regulatory and clinical data, we aim to make AI development transparent, decentralized, and verifiable from the ground up. This campaign is powered by Super Protocol, a decentralized cloud platform designed for privacy-preserving AI computing. It combines confidential execution, on-chain traceability, and cryptographic proof of origin, creating a secure foundation for open collaboration between AI systems and data contributors. @@ -13,13 +13,13 @@ This campaign is powered by Super Protocol, a decentralized cloud platform desig AI companies in regulated industries like healthcare face a difficult trade-off: build costly internal systems to collect and validate data, or rely on opaque, third-party pipelines with unknown provenance. Both come with serious limitations—compliance overhead, audit risks, and a lack of trust in the data itself. -This campaign explores a third path: a verifiable, decentralized pipeline for AI training. Every submitted data link is publicly auditable, cryptographically signed by the contributor, and logged to a smart contract on the opBNB network. It’s not just about finding data—it’s about proving where it came from and how it was used. +This campaign explores a third path: a verifiable, decentralized pipeline for AI training. Every submitted data link is publicly auditable, cryptographically signed by the contributor, and logged to a smart contract on the opBNB network. It's not just about finding data—it's about proving where it came from and how it was used. -We’re working with Tytonix, whose medical AI systems will be trained directly on this dataset. Their tools help medical device companies navigate regulatory approvals faster and at lower cost. Your contributions fuel a real-world application with immediate value. +We're working with Tytonix, whose medical AI systems will be trained directly on this dataset. Their tools help medical device companies navigate regulatory approvals faster and at lower cost. Your contributions fuel a real-world application with immediate value. ## Why verifiability is crucial -In healthcare AI, data integrity isn’t optional. It must be provable—both to regulators and the companies relying on it. +In healthcare AI, data integrity isn't optional. It must be provable—both to regulators and the companies relying on it. Super Protocol ensures every submission has a traceable origin, a clear audit trail, and immutable on-chain attribution. This builds a usable bridge between community-sourced input and production-grade AI. @@ -27,18 +27,18 @@ Super Protocol ensures every submission has a traceable origin, a clear audit tr - On-chain record → compliance-ready data - Decentralized sourcing → scalable, cost-effective pipelines -What’s submitted here isn’t just checked off—it’s accounted for. +What's submitted here isn't just checked off—it's accounted for. ## Just the beginning Super Protocol already supports confidential AI training: models run in secure environments where data remains private, even from developers. Deployments are signed, logged, and verifiable. That infrastructure is live. -What’s missing—until now—is granular, user-attributed input. The ability to train AI on individual contributions, where each data point is trackable, auditable, and tied to its source without sacrificing privacy. +What's missing—until now—is granular, user-attributed input. The ability to train AI on individual contributions, where each data point is trackable, auditable, and tied to its source without sacrificing privacy. -This campaign is the first step. In future phases, contributors will be able to control how their data is used, know when it contributes to training, and opt in or out of specific models. It’s the beginning of a long-term shift: from closed, anonymous datasets to a transparent, accountable, and privacy-respecting AI ecosystem. +This campaign is the first step. In future phases, contributors will be able to control how their data is used, know when it contributes to training, and opt in or out of specific models. It's the beginning of a long-term shift: from closed, anonymous datasets to a transparent, accountable, and privacy-respecting AI ecosystem. ## Where you come in Contribute real-world data. Climb the leaderboard. Earn your share of $30,000 in USDT and Super Stakes (convertible into Super Tokens at the token generation event). -This isn’t just a data campaign. It’s the foundation for an AI system that doesn’t require trust, because everything is verifiable, transparent, and owned. \ No newline at end of file +This isn't just a data campaign. It's the foundation for an AI system that doesn't require trust, because everything is verifiable, transparent, and owned. \ No newline at end of file diff --git a/docs/data-for-ai/Overview/dates.md b/docs/data-for-ai/Overview/dates.md index 3c7567b5..2f4c1d45 100644 --- a/docs/data-for-ai/Overview/dates.md +++ b/docs/data-for-ai/Overview/dates.md @@ -14,4 +14,4 @@ June 9 – June 23, 12:00 PM UTC
→ All activity counts toward leaderboard ranking and final rewards. **Daily Reset:**
-Every day at 12:00 PM UTC, submission limits are reset, and the points’ value increases by 4%. \ No newline at end of file +Every day at 12:00 PM UTC, submission limits are reset, and the points' value increases by 4%. \ No newline at end of file diff --git a/docs/data-for-ai/Overview/support.md b/docs/data-for-ai/Overview/support.md index dcd74251..13dab134 100644 --- a/docs/data-for-ai/Overview/support.md +++ b/docs/data-for-ai/Overview/support.md @@ -5,7 +5,7 @@ slug: "/overview/support" sidebar_position: 6 --- -If you have questions, encounter issues, or need assistance during the campaign, we’re here to help. +If you have questions, encounter issues, or need assistance during the campaign, we're here to help. ## Support ticket @@ -15,4 +15,4 @@ For official support via email, please [submit a request](https://superprotocol. If you prefer real-time communication, you can also get help through our [Discord server](https://discord.com/invite/superprotocol). The channel is **#data-for-ai**. -We’re committed to supporting you throughout the campaign. \ No newline at end of file +We're committed to supporting you throughout the campaign. \ No newline at end of file diff --git a/docs/data-for-ai/Rules/referrals.md b/docs/data-for-ai/Rules/referrals.md index a2187631..07958729 100644 --- a/docs/data-for-ai/Rules/referrals.md +++ b/docs/data-for-ai/Rules/referrals.md @@ -9,9 +9,9 @@ The referral system allows you to earn additional points by inviting others to j ## How it works -- After registration, you’ll receive a unique referral link. +- After registration, you'll receive a unique referral link. - When someone signs up using your link—a *referee*—and starts submitting valid data links, you earn referral points. -- There’s no limit to how many people you can refer. +- There's no limit to how many people you can refer. - Each participant can only be referred once. - If someone signs up without your link or uses another link first, they cannot be reassigned to you. @@ -27,13 +27,13 @@ Day 3: ~37.9 points
...
Day 14 (Final Day): ~58.8 points per link -The longer the campaign runs, the more valuable each referee’s activity becomes. +The longer the campaign runs, the more valuable each referee's activity becomes. Note: While later submissions earn more per link, inviting people early gives them time to contribute more overall, resulting in higher total rewards for you. ## Referral penalty -If your referee submits an invalid data link, you’ll lose the referral reward for one previously earned link from that referee. This only affects the bonus points earned from that specific referee and does not impact your own points or rewards from other referees. +If your referee submits an invalid data link, you'll lose the referral reward for one previously earned link from that referee. This only affects the bonus points earned from that specific referee and does not impact your own points or rewards from other referees. Referral points cannot go negative, and the same rule applies individually to each referee and each invalid link. diff --git a/docs/data-for-ai/Rules/rewards.md b/docs/data-for-ai/Rules/rewards.md index 7864d0a6..7bb9f9c4 100644 --- a/docs/data-for-ai/Rules/rewards.md +++ b/docs/data-for-ai/Rules/rewards.md @@ -7,7 +7,7 @@ sidebar_position: 3 ## Reward recipients -Only the top 1,000 participants will get prizes, and the rewards will depend on the rank. The rank is determined by the user’s total points: own points plus referral points. +Only the top 1,000 participants will get prizes, and the rewards will depend on the rank. The rank is determined by the user's total points: own points plus referral points. | **Rank** | **USDT** | **Super Stakes** | | :- | :- | :- | @@ -41,7 +41,7 @@ The top 50 participants might be subject to KYC checks to verify identity and pr ## Leaderboard -To check winners, participants, referrals, rewards, and more, [read the campaign’s smart contract](https://opbnb.bscscan.com/address/0x8c77ef6ed2ee514d1754fbfc2710d70e9d6ba871#readContract) on the opBNB network. +To check winners, participants, referrals, rewards, and more, [read the campaign's smart contract](https://opbnb.bscscan.com/address/0x8c77ef6ed2ee514d1754fbfc2710d70e9d6ba871#readContract) on the opBNB network. ### Check a participant @@ -65,7 +65,7 @@ Fields in the example in order of appearance: | `0` | Number of links validated today. Always `0` because the campaign has ended. | | `true` | Flag indicating if the address is registered as a campaign participant. | | `false` | Flag indicating if the address has claimed the reward. | -| `0x8da2c62C23aEBeb1Aa8b5eE96d341d26a2edec6eB` | The referrer’s address. | +| `0x8da2c62C23aEBeb1Aa8b5eE96d341d26a2edec6eB` | The referrer's address. | | `68` | Number of referees. | | `2640` | Points the participant earned for their referrer. | | `67738` | Points the participant earned from their referees. | @@ -73,7 +73,7 @@ Fields in the example in order of appearance: | `0` | Total number of duplicate links submitted. | | `237` | Total number of valid links submitted. | | `152` | Total number of invalid links submitted. | -| `0xbF4aC1b6efd5C21e5Ce93f34c8F43C8a9bCACA3F3` | The participant’s address. | +| `0xbF4aC1b6efd5C21e5Ce93f34c8F43C8a9bCACA3F3` | The participant's address. | | `813` | Current rank in the leaderboard. | | `97280` | Total points earned. | | `10000000000000000000` | USDT reward, in denominations. 1018 = 1 USDT. | diff --git a/docs/developers/deployment_guides/tunnels/repo.md b/docs/developers/deployment_guides/tunnels/repo.md index 101b3f1b..0f63e806 100644 --- a/docs/developers/deployment_guides/tunnels/repo.md +++ b/docs/developers/deployment_guides/tunnels/repo.md @@ -15,7 +15,7 @@ These Github Actions are automating the commands outlined in the [previous step] 1. Go to [GitHub](https://github.com) and log in to your account. -2. Click the [New Repository](https://github.com/new) button in the top-right. Enter `superprotocol-test-app` as repository name. You’ll have an option there to initialize the repository with a README file. Add `Node` as `.gitignore` template. +2. Click the [New Repository](https://github.com/new) button in the top-right. Enter `superprotocol-test-app` as repository name. You'll have an option there to initialize the repository with a README file. Add `Node` as `.gitignore` template. 3. Click the “Create repository” button. diff --git a/docs/developers/marketplace_gui/walkthrough.md b/docs/developers/marketplace_gui/walkthrough.md index 60febcd1..4a25bcd8 100644 --- a/docs/developers/marketplace_gui/walkthrough.md +++ b/docs/developers/marketplace_gui/walkthrough.md @@ -7,9 +7,9 @@ sidebar_position: 2 ## 1. Introduction -To better understand how Super Protocol works, let’s take a step-by-step walkthrough through the Marketplace GUI. +To better understand how Super Protocol works, let's take a step-by-step walkthrough through the Marketplace GUI. -As an example we’ll deploy the [Super Chat](/developers/offers/superchat) app with the tunnels. Please note that for this walkthrough we'll be using [Tunnels Launcher](/developers/offers/launcher), which cuts a few corners in order to streamline the experience. For the full tunnels deployment capabilities please refer to [this guide](/developers/deployment_guides/tunnels). +As an example we'll deploy the [Super Chat](/developers/offers/superchat) app with the tunnels. Please note that for this walkthrough we'll be using [Tunnels Launcher](/developers/offers/launcher), which cuts a few corners in order to streamline the experience. For the full tunnels deployment capabilities please refer to [this guide](/developers/deployment_guides/tunnels). You might want to read up on the fundamental Super Protocol concepts - such as [offers](/fundamentals/offers), [orders](/fundamentals/orders), [requirements and configurations](/fundamentals/slots), and [tunnels](/fundamentals/tunnels) - in advance, or - just dive into it and figure it out as you go. Your choice. @@ -142,7 +142,7 @@ To create this order via CLI, click the **Copy CLI workflow** button. It will ge :::info Step 6. Set up a passphrase. -Either input your own passphrase or generate a new one. Then press the `Place Order` button. Save your passphrase! You won’t be able to access your order results without it. For testing it's easier to have a single passphrase for all orders. +Either input your own passphrase or generate a new one. Then press the `Place Order` button. Save your passphrase! You won't be able to access your order results without it. For testing it's easier to have a single passphrase for all orders. ::: diff --git a/docs/hackathon/about.md b/docs/hackathon/about.md index 181ad43e..c1acdb32 100644 --- a/docs/hackathon/about.md +++ b/docs/hackathon/about.md @@ -7,7 +7,7 @@ sidebar_position: 1 ## Hackathon -The [Super Hackathon](https://hackathon.superprotocol.com/) is a global Web3 event designed to demonstrate the scalability and security of Super Protocol’s cloud under real on-chain load. Participants will migrate existing open-source dApps to opBNB, integrate confidential oracle data feeds, and generate verifiable transactions to stress-test performance. The goal is to showcase how real-world decentralized services can operate efficiently, privately, and transparently at scale. +The [Super Hackathon](https://hackathon.superprotocol.com/) is a global Web3 event designed to demonstrate the scalability and security of Super Protocol's cloud under real on-chain load. Participants will migrate existing open-source dApps to opBNB, integrate confidential oracle data feeds, and generate verifiable transactions to stress-test performance. The goal is to showcase how real-world decentralized services can operate efficiently, privately, and transparently at scale. ## Super Protocol @@ -15,7 +15,7 @@ The [Super Hackathon](https://hackathon.superprotocol.com/) is a global Web3 eve ## Confidential oracles -Confidential oracles are a key showcase of Super Protocol’s architecture and the advantages of confidential execution. Built on Chainlink Data Feeds and executed inside TEEs, they keep all data and computations private while remaining verifiable on-chain. +Confidential oracles are a key showcase of Super Protocol's architecture and the advantages of confidential execution. Built on Chainlink Data Feeds and executed inside TEEs, they keep all data and computations private while remaining verifiable on-chain. Traditional oracles rely on thousands of untrusted nodes to reach consensus, making the whole process quite expensive. Super Protocol achieves the same trust with far fewer nodes, as each operates inside a TEE that cryptographically guarantees honest execution. A single node with 3 CPUs and 4 GB RAM can handle the workload of about 1,000 Chainlink nodes, delivering major improvements in speed and cost efficiency. @@ -54,7 +54,7 @@ Prizes are awarded to the team as a whole, not to individual participants or pro ## Community & support -Official discussions and support take place in Super Protocol’s [Discord server](https://discord.gg/superprotocol), channel #hackathons. +Official discussions and support take place in Super Protocol's [Discord server](https://discord.gg/superprotocol), channel #hackathons. Sign up for our newsletter and social media on the [Super Hackathon webpage](https://hackathon.superprotocol.com/) to keep up to date. diff --git a/docs/hackathon/liquity.md b/docs/hackathon/liquity.md index d51815a9..f80debef 100644 --- a/docs/hackathon/liquity.md +++ b/docs/hackathon/liquity.md @@ -94,7 +94,7 @@ Below is an example of partial console output: ## 6. Configure for opBNB Deployment -Now that local deployment works, let’s prepare the project for deployment to the opBNB mainnet. +Now that local deployment works, let's prepare the project for deployment to the opBNB mainnet. ### 6.1. Create the environment file diff --git a/docs/hackathon/rules.md b/docs/hackathon/rules.md index 53a72db5..6930d7c8 100644 --- a/docs/hackathon/rules.md +++ b/docs/hackathon/rules.md @@ -17,7 +17,7 @@ The interface methods (`latestAnswer`, `getAnswer`, `latestRound`, `getRoundData The dApp must be open-source and have been publicly deployed before September 1, 2025, on Ethereum, Polygon, or BNB Chain. -The chosen dApp’s original smart contracts must be verified on a public block explorer (e.g., Etherscan, BscScan, etc.). +The chosen dApp's original smart contracts must be verified on a public block explorer (e.g., Etherscan, BscScan, etc.). The migration should require minimal code changes—no more than 5% of the original codebase. @@ -25,7 +25,7 @@ Teams may submit multiple unique dApps, but each must have a different original Frontends are welcome but optional—evaluation is based solely on the deployed smart contracts and their on-chain activity. -The project’s license must allow forking and reuse (acceptable licenses include MIT, Apache 2.0, GPL-family, or equivalent). +The project's license must allow forking and reuse (acceptable licenses include MIT, Apache 2.0, GPL-family, or equivalent). ## Deploying to opBNB diff --git a/docs/hackathon/venus-protocol.md b/docs/hackathon/venus-protocol.md index d4f828a7..c0924b9c 100644 --- a/docs/hackathon/venus-protocol.md +++ b/docs/hackathon/venus-protocol.md @@ -141,7 +141,7 @@ For example, [opbnb.bscscan.com/address/0x6DA2Fe3A44dc2837e1ffc450339Ae107AE1AC2 ## 12. Submit the migration -To complete the migration, you’ll need both the original and new contract addresses. +To complete the migration, you'll need both the original and new contract addresses. ### 12.1. Locate the original deployment diff --git a/docs/whitepaper/abstract.md b/docs/whitepaper/abstract.md index 31c74761..6e25470f 100644 --- a/docs/whitepaper/abstract.md +++ b/docs/whitepaper/abstract.md @@ -13,7 +13,7 @@ The key Web3 concept is to create open, decentralized alternatives for all the p

-But decentralization is not the only defining feature of the Web3 concept. It is expected that the following technologies will play a key role in the future: Big Data, AI, IoT, and VR/AR. These technologies require a lot of computational capacity and access to data, know-how and specific tools for creating cutting edge products. The lion’s share of the cloud services market at the moment is [controlled by only three corporations](https://www.canalys.com/newsroom/global-cloud-market-Q121). The same corporations and a number of other similar entities also control most of the data and technologies that will be fundamental for the Internet of the future. +But decentralization is not the only defining feature of the Web3 concept. It is expected that the following technologies will play a key role in the future: Big Data, AI, IoT, and VR/AR. These technologies require a lot of computational capacity and access to data, know-how and specific tools for creating cutting edge products. The lion's share of the cloud services market at the moment is [controlled by only three corporations](https://www.canalys.com/newsroom/global-cloud-market-Q121). The same corporations and a number of other similar entities also control most of the data and technologies that will be fundamental for the Internet of the future. In addition to massive centralization of computational capacity, [the year 2020 also saw a serious shortage thereof](https://en.wikipedia.org/wiki/2020%E2%80%932021_global_chip_shortage). This is happening at the time when millions of GPUs are used worldwide [to mine cryptocurrencies](https://en.wikipedia.org/wiki/Proof_of_work) even though they could be deployed to help develop and promote AI solutions in such key areas as healthcare, logistics, education, etc. diff --git a/docs/whitepaper/blockchain-solution.md b/docs/whitepaper/blockchain-solution.md index 262c8724..0ea16595 100644 --- a/docs/whitepaper/blockchain-solution.md +++ b/docs/whitepaper/blockchain-solution.md @@ -21,7 +21,7 @@ To ensure order processing, the blockchain environment provides an infrastructur * **TEE Offers** * **Orders** -Now let’s take a look at each smart contract in detail. +Now let's take a look at each smart contract in detail. ### Basic smart contract for the Super Protocol Config system @@ -257,7 +257,7 @@ The offer describes the cost of using it and the minimum order deposit. To maint | name | string | offer name | | description | string | offer description | | linkage | string | linkage spec, for example, for docker | -| restrictions | string | possible restrictions and requirements for various provider offers. Used when creating an order. E.g.: ‘{“TEE”: [GUID1, GUID2], “Storage”, “Solution”: [GUID3, GUID4]}’ | +| restrictions | string | possible restrictions and requirements for various provider offers. Used when creating an order. E.g.: ‘{“TEE”: [GUID1, GUID2], “Storage”, “Solution”: [GUID3, GUID4]}' | | slots | [{SlotInfo; OptionInfo; SlotUsage}] | array of provided configurations and conditions for their use | | input | string | input data format | | output | string | output data format | @@ -399,7 +399,7 @@ The results of the execution or encountered errors are later added up to the ord | **cancelOrder(guid orderId) public returns(bool)** | order.consumer | blockchain | |

Request to stop execution of the order on the consumer's side. The order status is changed to "canceling", the provider saves the end result of the order and moves the order to "canceled" status. If the offer is of cancelable type, smart contract immediately refunds the remaining deposit based on the proportion of time running or depositSpent. If the offer is of non-cancellable type, the provider sets a fee for their work after the order is complete.

This method works only when all sub-orders are stopped.

| | | | **refillOrder(guid orderId, uint256 orderAmount)** | order.consumer | blockchain | -| Replenishment of the deposit by the customer. Normally required when renewing a rental. It can also be used to obtain additional results if that is supported by the provider’s offer. | | | +| Replenishment of the deposit by the customer. Normally required when renewing a rental. It can also be used to obtain additional results if that is supported by the provider's offer. | | | | **withdrawProfit(guid orderId) public** | order.provider.tokenReceiver | SDK + blockchain | | Order profit withdrawal by the provider. Available after the order is executed. In this case, the profit is transferred to deferred payments for the number of days specified in the protocol settings (_profitWithdrawDelayDays_). | | | | **withdrawChange(guid orderId) public** | order.consumer | SDK + blockchain | diff --git a/docs/whitepaper/high-level-description.md b/docs/whitepaper/high-level-description.md index 5a660198..6f7a05fe 100644 --- a/docs/whitepaper/high-level-description.md +++ b/docs/whitepaper/high-level-description.md @@ -9,7 +9,7 @@ sidebar_position: 5

-From a bird’s eye view, Super Protocol involves the interactions shown in the above diagram. The interactions include the following entities: +From a bird's eye view, Super Protocol involves the interactions shown in the above diagram. The interactions include the following entities: - **Provider Offers.** In a form of a provider offer, the provider offers their resources or values in exchange for a certain reward. The offer can fall into one of three categories: - **Input.** Offers of this type are used for cooperative processing within a trusted execution environment (TEE). These can be data offers or solution offers. diff --git a/docs/whitepaper/target-audience.md b/docs/whitepaper/target-audience.md index 3be24d01..9e2b8787 100644 --- a/docs/whitepaper/target-audience.md +++ b/docs/whitepaper/target-audience.md @@ -24,7 +24,7 @@ Super Protocol is very unique in a way that it allows equipment owners to engage Data in the modern world is being created everywhere, while new, more advanced processing algorithms allow for an ever larger number of ways to use this data. However, there are quite a few challenges here. Obviously, large volumes of data are not originally meant to be public, which means it requires anonymization or confidential computing. -High-quality anonymization is not always possible without losing data utility. Additionally, many of today’s analytical tools enable successful [data de-anonymization](https://www.cs.utexas.edu/~shmat/shmat_oak09.pdf) under many different circumstances: “To demonstrate its effectiveness on real-world networks, we show that a third of the users who can be verified to have accounts on both Twitter, a popular microblogging service, and Flickr, an online photo-sharing site, can be re-identified in the anonymous Twitter graph with only a 12% error rate.” +High-quality anonymization is not always possible without losing data utility. Additionally, many of today's analytical tools enable successful [data de-anonymization](https://www.cs.utexas.edu/~shmat/shmat_oak09.pdf) under many different circumstances: “To demonstrate its effectiveness on real-world networks, we show that a third of the users who can be verified to have accounts on both Twitter, a popular microblogging service, and Flickr, an online photo-sharing site, can be re-identified in the anonymous Twitter graph with only a 12% error rate.” Almost any data owner would benefit from monetizing it—as long as it does not harm their business as a whole. This is borne out by the widespread development of technologies for analyzing big data. From 8c8f617de8623f586c2d1eba81e37679c89c6f04 Mon Sep 17 00:00:00 2001 From: k3dz0r Date: Thu, 4 Dec 2025 12:57:52 -0300 Subject: [PATCH 2/5] cli: corrections to fine-tune and collaboration (Vlad's) --- docs/cli/Guides/collaboration.md | 25 ++++++++++----------- docs/cli/Guides/confidential-fine-tuning.md | 24 +++++++++----------- 2 files changed, 22 insertions(+), 27 deletions(-) diff --git a/docs/cli/Guides/collaboration.md b/docs/cli/Guides/collaboration.md index 100835d3..c0fecb6f 100644 --- a/docs/cli/Guides/collaboration.md +++ b/docs/cli/Guides/collaboration.md @@ -42,9 +42,8 @@ sequenceDiagram note over Alice,Blockchain: Execution Alice ->>+ Super Protocol / TEE: 8. Place an order - Super Protocol / TEE ->> Storage: Download the solution - Bob ->> Super Protocol / TEE: 9. Complete the data suborder - Super Protocol / TEE ->> Storage: Download the dataset + Bob ->> Super Protocol / TEE: 9. Approve the usage of the dataset + Super Protocol / TEE ->> Storage: Download the solution and dataset Super Protocol / TEE ->> Blockchain: Publish the order report Super Protocol / TEE ->> Super Protocol / TEE: Process the order Super Protocol / TEE ->>- Storage: Upload the order results @@ -57,23 +56,23 @@ sequenceDiagram **Preparation** -Alice builds a solution—a Docker image containing her script (1). She uploads the solution using SPCTL (2) and grants Bob access for verification (3). +Alice builds a solution—a Docker image containing her script ([1](/cli/guides/collaboration#alice-1-build-a-solution)). She uploads the solution using SPCTL ([2](/cli/guides/collaboration#alice-2-upload-the-solution)) and grants Bob access for verification ([3](/cli/guides/collaboration#alice-3-send-the-solution-to-bob)). -Bob (or an independent auditor) downloads the solution (4) and verifies that it is safe to process his data (5). +Bob (or an independent auditor) downloads the solution ([4](/cli/guides/collaboration#bob-4-download-the-solution)) and verifies that it is safe to process his data ([5](/cli/guides/collaboration#bob-5-verify-the-solution)). -Bob uploads his dataset to remote storage using SPCTL (6). The dataset is automatically encrypted during upload, and only Bob holds the key. +Bob uploads his dataset to remote storage using SPCTL ([6](/cli/guides/collaboration#bob-6-upload-the-dataset)). The dataset is automatically encrypted during upload, and only Bob holds the key. -Bob creates an offer on the Marketplace (7). The offer requires Bob's manual approval for use. He shares the offer's IDs with Alice. +Bob creates an offer on the Marketplace ([7](/cli/guides/collaboration#bob-7-create-an-offer)). The offer requires Bob's manual approval for use. He shares the offer's IDs with Alice. **Execution** -Alice places an order on Super Protocol using her solution and Bob's offer ID (8). The order remains **Blocked** by the data suborder. +Alice places an order on Super Protocol using her solution and Bob's offer ID ([8](/cli/guides/collaboration#alice-8-place-an-order)). The order remains **Blocked** by the data suborder. -Bob manually completes the data suborder (9). The command includes the verified solution hash. Completion succeeds only if this hash matches the actual solution hash, meaning the solution was not altered. +Bob manually approves the usage of his dataset for the image with a specific hash ([9](/cli/guides/collaboration#bob-9-complete-the-data-suborder)). If this hash matches the actual solution hash, the CVM begins to process the order. If the hashes do not match, the order will be terminated with an error. -Once the computation finishes, Alice can download the result (10). All the data within the TEE (solution, dataset, order results, etc.) is automatically deleted. +Once the computation finishes, Alice can download the result ([10](/cli/guides/collaboration#alice-10-download-the-order-results)). All the data within the TEE (solution, dataset, order results, etc.) is automatically deleted. -Both Alice and Bob can retrieve the order report (11) that confirms the authenticity of the entire trusted setup. +Both Alice and Bob can retrieve the order report ([11](/cli/guides/collaboration#alice-and-bob-11-get-the-order-report)) that confirms the authenticity of the entire trusted setup. ## Prerequisites @@ -112,7 +111,7 @@ You can find several Dockerfile examples in the [Super-Protocol/solutions](https 1.2. Build an image: ```shell -docker build -t . +docker build --platform linux/amd64 -t . ``` Replace `` with the name of your solution. @@ -326,7 +325,7 @@ If the order ended up with an error, the results will contain execution logs tha ### Alice and Bob: 11. Get the order report -You can get the order report as soon as the order status becomes `Processing` without waiting for the order to complete: +You can get the order report as soon as the CVM downloads the order components and starts the execution, without waiting for the order to complete: ```shell ./spctl orders get-report --save-to report.json diff --git a/docs/cli/Guides/confidential-fine-tuning.md b/docs/cli/Guides/confidential-fine-tuning.md index b67708ed..c3832876 100644 --- a/docs/cli/Guides/confidential-fine-tuning.md +++ b/docs/cli/Guides/confidential-fine-tuning.md @@ -54,13 +54,13 @@ sequenceDiagram actor Alice actor Bob participant Storage - participant Super Protocol / TEE + participant Super Protocol - note over Alice,Super Protocol / TEE: Prepare the data + note over Alice,Super Protocol: Prepare the data Alice ->> Storage: 6. Upload the model Bob ->> Storage: 7. Upload the dataset - Bob ->> Super Protocol / TEE: 8. Create an offer + Bob ->> Super Protocol: 8. Create an offer ```
@@ -81,10 +81,8 @@ sequenceDiagram note over Alice,Blockchain: Execute Alice ->>+ Super Protocol / TEE: 9. Place an order - Super Protocol / TEE ->> Storage: Download the solution - Super Protocol / TEE ->> Storage: Download the model - Bob ->> Super Protocol / TEE: 10. Complete the suborder - Super Protocol / TEE ->> Storage: Download the dataset + Bob ->> Super Protocol / TEE: 10. Approve the usage of the dataset + Super Protocol / TEE ->> Storage: Download the solution, model, and dataset Super Protocol / TEE ->> Blockchain: Publish the order report Super Protocol / TEE ->> Super Protocol / TEE: Process the order Super Protocol / TEE ->>- Storage: Upload the order results @@ -94,13 +92,11 @@ sequenceDiagram ```
-Alice places an order on Super Protocol ([9](/cli/guides/fine-tune#alice-9-place-an-order)), adding the solution, her model, and Bob's offer. The order does not proceed automatically and remains `Blocked` by the data suborder with Bob's dataset. - -Bob manually completes the respective data suborder ([10](/cli/guides/fine-tune#bob-10-complete-the-data-suborder)). The command he uses includes the solution hash. The completion will be successful only if this hash matches the actual solution hash. +Alice places an order on Super Protocol ([9](/cli/guides/fine-tune#alice-9-place-an-order)), adding the solution, her model, and Bob's offer. The order does not proceed automatically and remains `Blocked`. -If the suborder is completed successfully, the execution of the main order proceeds. +Bob manually approves the usage of his dataset for the image with a specific hash ([10](/cli/guides/fine-tune#bob-10-complete-the-data-suborder)). If this hash matches the actual solution hash, the CVM begins to process the order. If the hashes do not match, the order will be terminated with an error. -When the main order is complete, Alice downloads the result ([11](/cli/guides/fine-tune#alice-11-download-the-order-results)). All the data within the TEE (solution, AI model, dataset, order results, etc.) is automatically deleted. +When the order is complete, Alice downloads the result ([11](/cli/guides/fine-tune#alice-11-download-the-order-results)). All the data within the TEE (solution, AI model, dataset, order results, etc.) is automatically deleted. Both Alice and Bob can retrieve the order report ([12](/cli/guides/fine-tune#alice-and-bob-12-get-the-order-report)) that confirms the authenticity of the entire trusted setup. @@ -149,7 +145,7 @@ You can find several Dockerfile examples in the [Super-Protocol/solutions](https 1.2. Build an image: ```shell -docker build -t . +docker build --platform linux/amd64 -t . ``` Replace `` with the name of your solution. @@ -386,7 +382,7 @@ If the order ended up with an error, the results will contain execution logs tha ### Alice and Bob: 12. Get the order report -You can get the order report as soon as the order status becomes `Processing` without waiting for the order to complete: +You can get the order report as soon as the CVM downloads the order components and starts the execution, without waiting for the order to complete: ```shell ./spctl orders get-report --save-to report.json From 8a30a927583a9996371984560926c372fa77e1ca Mon Sep 17 00:00:00 2001 From: k3dz0r Date: Thu, 11 Dec 2025 13:41:20 -0300 Subject: [PATCH 3/5] cli: add solutions guides --- .../Guides/Solutions/comfyui.md} | 26 +-- docs/cli/Guides/Solutions/tgwui.md | 6 + docs/cli/Guides/Solutions/unsloth.md | 189 ++++++++++++++++++ docs/cli/Guides/Solutions/vllm.md | 101 ++++++++++ docs/cli/Guides/collaboration.md | 10 +- docs/cli/Guides/confidential-fine-tuning.md | 20 +- docs/cli/Guides/provider-tools.md | 2 +- docs/cli/Guides/quick-guide.md | 16 +- docs/cli/index.md | 3 +- docs/guides/index.md | 19 +- docs/marketplace/Guides/deploy-model.md | 2 +- 11 files changed, 352 insertions(+), 42 deletions(-) rename docs/{marketplace/Guides/prepare-comfyui.md => cli/Guides/Solutions/comfyui.md} (91%) create mode 100644 docs/cli/Guides/Solutions/tgwui.md create mode 100644 docs/cli/Guides/Solutions/unsloth.md create mode 100644 docs/cli/Guides/Solutions/vllm.md diff --git a/docs/marketplace/Guides/prepare-comfyui.md b/docs/cli/Guides/Solutions/comfyui.md similarity index 91% rename from docs/marketplace/Guides/prepare-comfyui.md rename to docs/cli/Guides/Solutions/comfyui.md index 5b8dc8eb..aa1cab11 100644 --- a/docs/marketplace/Guides/prepare-comfyui.md +++ b/docs/cli/Guides/Solutions/comfyui.md @@ -1,14 +1,14 @@ --- -id: "prepare-comfyui" -title: "Prepare a ComfyUI Workflow" -slug: "/guides/prepare-comfyui" -sidebar_position: 5 +id: "comfyui" +title: "ComfyUI" +slug: "/guides/solutions/comfyui" +sidebar_position: 2 --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -This guide provides step-by-step instructions for preparing a **ComfyUI** workflow with custom nodes before uploading it. For security reasons, you cannot upload custom nodes directly to a deployed ComfyUI. +This guide provides step-by-step instructions for preparing a **ComfyUI** workflow with custom nodes to run on Super Protocol. For security reasons, you cannot upload custom nodes directly to a deployed ComfyUI. :::note @@ -28,7 +28,7 @@ You can prepare your model, workflow, and custom node files manually or using Do 1. Clone the [Super-Protocol/solutions](https://github.com/Super-Protocol/solutions/) GitHub repository to the location of your choosing: - ``` + ```shell git clone https://github.com/Super-Protocol/solutions.git --depth 1 ``` @@ -54,13 +54,13 @@ You can prepare your model, workflow, and custom node files manually or using Do Access the running container with the following command: - ``` + ```shell docker exec -it comfyui bash ``` Go to the `models` directory inside the container and download the model files to the corresponding subdirectories using the `wget` command. For example: - ``` + ```shell wget https://huggingface.co/prompthero/openjourney/resolve/main/mdjrny-v4.safetensors ``` @@ -68,7 +68,7 @@ You can prepare your model, workflow, and custom node files manually or using Do If you have the model on your computer, copy its files to the container using the following command: - ``` + ```shell docker cp comfyui: ``` @@ -77,7 +77,7 @@ You can prepare your model, workflow, and custom node files manually or using Do For example: - ``` + ```shell docker cp ~/Downloads/openjourney/mdjrny-v4.safetensors comfyui:/opt/ComfyUI/models/checkpoints/mdjrny-v4.safetensors ``` @@ -87,7 +87,7 @@ You can prepare your model, workflow, and custom node files manually or using Do 8. Unpack the archive using the following command: - ``` + ```shell tar -xvzf snapshot.tar.gz -C ``` @@ -159,6 +159,6 @@ You can prepare your model, workflow, and custom node files manually or using Do -## Contact Super Protocol +## Support -If you face any issues, contact Super Protocol on [Discord](https://discord.gg/superprotocol) or via the [contact form](https://superprotocol.zendesk.com/hc/en-us/requests/new). \ No newline at end of file +If you have any issues or questions, contact Super Protocol on [Discord](https://discord.gg/superprotocol) or via the [contact form](https://superprotocol.zendesk.com/hc/en-us/requests/new). \ No newline at end of file diff --git a/docs/cli/Guides/Solutions/tgwui.md b/docs/cli/Guides/Solutions/tgwui.md new file mode 100644 index 00000000..d6ce3bb0 --- /dev/null +++ b/docs/cli/Guides/Solutions/tgwui.md @@ -0,0 +1,6 @@ +--- +id: "tgwui" +title: "Text Generation WebUI" +slug: "/guides/solutions/tgwui" +sidebar_position: 1 +--- \ No newline at end of file diff --git a/docs/cli/Guides/Solutions/unsloth.md b/docs/cli/Guides/Solutions/unsloth.md new file mode 100644 index 00000000..02d0b996 --- /dev/null +++ b/docs/cli/Guides/Solutions/unsloth.md @@ -0,0 +1,189 @@ +--- +id: "unsloth" +title: "Unsloth" +slug: "/guides/solutions/unsloth" +sidebar_position: 3 +--- + +This guide provides step-by-step instructions for fine-tuning an AI model using the Super Protocol packaging of [Unsloth](https://unsloth.ai/), an open-source framework for LLM fine-tuning and reinforcement learning. + +The solution allows you to run fine-tuning within Super Protocol's Trusted Execution Environment (TEE). This provides enhanced security and privacy and enables a range of [confidential collaboration](https://docs.develop.superprotocol.com/cli/guides/fine-tune) scenarios. + +## Prerequisites + +- [SPCTL](https://docs.develop.superprotocol.com/cli/) +- Git +- BNB and SPPI tokens (opBNB) to pay for transactions and orders + +## Repository + +Clone the repository with Super Protocol solutions: + +```shell +git clone https://github.com/Super-Protocol/solutions.git +``` + +The Unsloth solution includes a Dockerfile and a helper script `run-unsloth.sh` that facilitates workflow creation. Note that `run-unsloth.sh` does not build an image and instead uses a pre-existing solution offer. + +## run-unsloth.sh + +Copy SPCTL’s binary and its `config.json` to the `unsloth/scripts` directory inside the cloned Super-Protocol/solutions repository. + +### 1. Prepare training scripts + +When preparing your training scripts, keep in mind the special file structure within the TEE: + +| **Location** | **Purpose** | **Access** | +| :- | :- | :- | +| `/sp/inputs/input-0001`
`/sp/inputs/input-0002`
etc. | Possible data locations
(AI model, dataset, training scripts, etc.) | Read-only | +| `/sp/output` | Output directory for results | Read and write | +| `/sp/certs` | Contains the order certificate, private key, and `workloadInfo` | Read-only | + +Your scripts must find the data in `/sp/inputs` and write the results to `/sp/output`. + +### 2. Place an order + +2.1. Initiate a dialog to construct and place an order: + +```shell +./run-unsloth.sh +``` + +2.2. `Enter TEE offer id (number)`: Enter a compute offer ID. This determines the available compute resources and cost of your order. You can find the full list of available compute offers on the [Marketplace](https://marketplace.superprotocol.com/). + +2.3. `Choose run mode`: `1) file`. + +2.4. `Select the model option`: + +- `1) Medgemma 27b (offer 15900)`: Select this option if you need an untuned MedGemma 27B. +- `2) your model`: Select this option to use another model. Further, when prompted about `Model input`, enter one of the following: + - a path to the model's resource JSON file, if it was already uploaded with SPCTL + - model offer ID, if the model exists on the Marketplace + - a path to the local directory with the model to upload it using SPCTL. +- `3) no model`: No model will be used. + +2.5. `Enter path to a .py/.ipynb file OR a directory`: Enter the path to your training script (file or directory). For a directory, select the file to run (entrypoint) when prompted. Note that you cannot reuse resource files in this step; scripts should be uploaded every time. + +2.6. `Provide your dataset as a resource JSON path, numeric offer id, or folder path`: As with the model, enter one of the following: + +- a path to the dataset's resource JSON file, if it was already uploaded with SPCTL +- dataset offer ID, if the dataset exists on the Marketplace +- a path to the local directory with the dataset to upload it using SPCTL. + +2.7. `Upload SPCTL config file as a resource?`: Answer `N` unless you need to use SPCTL from within the TEE during the order execution. In this case, your script should run a `curl` command to download SPCTL and find the uploaded `config.json` in the `/sp/inputs/` subdirectories. + +2.8. Wait for the order to be created and find the order ID in the output, for example: + +```shell +Unsloth order id: 259126 +Done. +``` + +### 3. Check the order result + +3.1. The order will take some time to complete. Check the order status: + +```shell +./spctl orders get +``` + +Replace `` with your order ID. + +If you lost the order ID, check all your orders to find it: + +```shell +./spctl orders list --my-account --type tee +``` + +3.2. When the order status is `Done` or `Error`, download the result: + +```shell +./spctl orders download-result +``` + +The downloaded TAR.GZ archive contains the results in the `output` directory and execution logs. + +## Dry run + +```shell +./run-unsloth.sh --suggest-only +``` + +The option `--suggest-only` allows you to perform a dry run without actually uploading files and creating orders. + +Complete the dialog, as usual; only use absolute paths. + +In the output, you will see a prepared command for running the script non-interactively, allowing you to easily modify the variables and avoid re-entering the dialog. For example: + +```shell +RUN_MODE=file \ +RUN_DIR=/home/user/Downloads/yma-run \ +RUN_FILE=sft_example.py \ +DATA_RESOURCE=/home/user/unsloth/scripts/yma_data_example-data.json \ +MODEL_RESOURCE=/home/user/unsloth/scripts/medgemma-27b-ft-merged.resource.json \ +/home/user/unsloth/scripts/run-unsloth.sh \ +--tee 8 \ +--config ./config.json +``` + +## Jupyter Notebook + +You can launch and use Jupyter Notebook instead of uploading training scripts directly. + +Initiate a dialog: + +```shell +./run-unsloth.sh +``` + +When prompted: + +1. `Enter TEE offer id`: Enter a compute offer ID. This determines the available compute resources and cost of your order. You can find the full list of available compute offers on the [Marketplace](https://marketplace.superprotocol.com/). + +2. `Choose run mode`: `2) jupyter-server`. + +3. `Select the model option`: + +- `1) Medgemma 27b (offer 15900)`: Select this option if you need an untuned MedGemma 27B. +- `2) your model`: Select this option to use another model. Further, when prompted about `Model input`, enter one of the following: + - a path to the model's resource JSON file, if it was already uploaded with SPCTL + - model offer ID, if the model exists on the Marketplace + - a path to the local directory with the model to upload it using SPCTL. +- `3) no model`: No model will be used. + +4. `Enter Jupyter password` or press Enter to proceed without a password. + +5. `Select domain option`: + +- `1) Temporary Domain (*.superprotocol.io)` is suitable for testing and quick deployments. +- `2) Own domain` will require you to provide a domain name, TLS certificate, private key, and a tunnel server auth token. + +Wait for the Tunnels Launcher order to be created. + +6. `Provide your dataset as a resource JSON path, numeric offer id, or folder path`: As with the model, enter one of the following: +- a path to the dataset's resource JSON file, if it was already uploaded with SPCTL +- dataset offer ID, if the dataset exists on the Marketplace +- a path to the local directory with the dataset to upload it using SPCTL. + +7. `Upload SPCTL config file as a resource?`: Answer `N` unless you need to use SPCTL from within the TEE during the order execution. In this case, your script should run a `curl` command to download SPCTL and find the uploaded `config.json` in the `/sp/inputs/` subdirectories. + +8. Wait for the Jupyter order to be ready and find a link in the output; for example: + +```shell +=================================================== +Jupyter instance is available at: https://beja-bine-envy.superprotocol.io +=================================================== +``` + +8. Open the link in your browser to access Jupyter’s UI. + +**Note**: + +The data in `/sp/output` will not be published as the order result when running the Jupyter server. To save your fine-tuning results, upload them either: +- via Python code +- using the integrated terminal in the Jupyter server +- using SPCTL with the config uploaded at Step 7. + +## Support + +If you have any issues or questions, contact Super Protocol on [Discord](https://discord.gg/superprotocol) or via the [contact form](https://superprotocol.zendesk.com/hc/en-us/requests/new). \ No newline at end of file diff --git a/docs/cli/Guides/Solutions/vllm.md b/docs/cli/Guides/Solutions/vllm.md new file mode 100644 index 00000000..cda0ab5d --- /dev/null +++ b/docs/cli/Guides/Solutions/vllm.md @@ -0,0 +1,101 @@ +--- +id: "vllm" +title: "vLLM" +slug: "/guides/solutions/vllm" +sidebar_position: 4 +--- + +This guide provides step-by-step instructions for running an AI model inference using the Super Protocol packaging of [vLLM](https://www.vllm.ai/), an inference and serving engine for LLMs. + +The solution allows you to run LLM inference within Super Protocol's Trusted Execution Environment (TEE). + +## Prerequisites + +- [SPCTL](https://docs.develop.superprotocol.com/cli/) +- Git +- BNB and SPPI tokens (opBNB) to pay for transactions and orders + +## Repository + +Clone the repository with Super Protocol solutions: + +```shell +git clone https://github.com/Super-Protocol/solutions.git +``` + +The vLLM solution includes a Dockerfile and a helper script `run-vllm.sh` that facilitates workflow creation. Note that `run-vllm.sh` does not build an image and instead uses a pre-existing solution offer. + +## run-vllm.sh + +Copy SPCTL’s binary and its `config.json` to the `vllm/scripts` directory inside the cloned Super-Protocol/solutions repository. + +### Place an order + +1. Initiate a dialog to construct and place an order: + +```shell +./run-vllm.sh +``` + +2. `Select domain option`: + +- `1) Temporary Domain (*.superprotocol.io)` is suitable for testing and quick deployments. +- `2) Own domain` will require you to provide a domain name, TLS certificate, private key, and a tunnel server auth token. + +3. `Enter TEE offer id`: Enter a compute offer ID. This determines the available compute resources and cost of your order. You can find the full list of available compute offers on the [Marketplace](https://marketplace.superprotocol.com/). + +4. `Provide model as resource JSON path, numeric offer id, or folder path`: Enter one of the following: + +- a path to the model's resource JSON file, if it was already uploaded with SPCTL +- model offer ID, if the model exists on the Marketplace +- a path to the local directory with the model to upload it using SPCTL. + +5. `Enter API key` or press `Enter` to generate one automatically. + +Wait for the deployment to be ready and find the information about it in the output, for example: + +```shell +=================================================== +VLLM server is available at: https://whau-trug-nail.superprotocol.io +API key: d75c577d-e538-4d09-8f59-a0f00ae961a3 +Order IDs: Launcher=269042, VLLM=269044 +=================================================== +``` + +### API + +Once deployed on Super Protocol, your model runs inside a TEE and exposes an OpenAI-compatible API. You can interact with it as you would with a local vLLM instance. + +Depending on the type of request you want to make, use the following API endpoints: + +- Chat Completions (`/v1/chat/completions`) +- Text Completions (`/v1/completions`) +- Embeddings (`/v1/embeddings`) +- Audio Transcriptions & Translations (`/v1/audio/transcriptions`, `/v1/audio/translations`) + +See the [full list of API endpoints](https://docs.vllm.ai/en/latest/serving/openai_compatible_server/). + +## Dry run + +```shell +./run-vllm.sh --suggest-only +``` + +The option `--suggest-only` allows you to perform a dry run without actually uploading files and creating orders. + +Complete the dialog, as usual; only use absolute paths. + +In the output, you will see a prepared command for running the script non-interactively, allowing you to easily modify the variables and avoid re-entering the dialog. For example: + +```shell +RUN_MODE=temporary \ +MODEL_RESOURCE=55 \ +VLLM_API_KEY=9c6dbf44-cef7-43a4-b362-43295b244446 \ +/home/user/vllm/scripts/run-vllm.sh \ +--config ./config.json \ +--tee 8 +``` + +## Support + +If you have any issues or questions, contact Super Protocol on [Discord](https://discord.gg/superprotocol) or via the [contact form](https://superprotocol.zendesk.com/hc/en-us/requests/new). \ No newline at end of file diff --git a/docs/cli/Guides/collaboration.md b/docs/cli/Guides/collaboration.md index c0fecb6f..b6540bab 100644 --- a/docs/cli/Guides/collaboration.md +++ b/docs/cli/Guides/collaboration.md @@ -92,11 +92,11 @@ Both Alice and Bob can retrieve the order report ([11](/cli/guides/collaboration 1.1. Write a Dockerfile that creates an image with your code. Keep in mind the special file structure inside the TEE: -| **Location** | **Purpose** | **Access** | -| :- | :- | :- | -| `/sp/inputs/input-0001/`
`/sp/inputs/input-0002/`
etc. | Possible data locations | Read-only | -| `/sp/output/` | Output directory for results | Write; read own files | -| `/sp/certs/` | Contains the order certificate | Read-only | +| **Location** | **Purpose** | **Access** | +| :- | :- | :- | +| `/sp/inputs/input-0001/`
`/sp/inputs/input-0002/`
etc. | Possible data locations | Read-only | +| `/sp/output/` | Output directory for results | Write; read own files | +| `/sp/certs/` | Contains the order certificate, private key, and workloadInfo | Read-only | Your scripts must find the data in `/sp/inputs/` and write the results to `/sp/output/`. diff --git a/docs/cli/Guides/confidential-fine-tuning.md b/docs/cli/Guides/confidential-fine-tuning.md index c3832876..f68d7f63 100644 --- a/docs/cli/Guides/confidential-fine-tuning.md +++ b/docs/cli/Guides/confidential-fine-tuning.md @@ -1,21 +1,21 @@ --- id: "fine-tune" -title: "Confidential Fine-Tuning" +title: "Confidential Collaboration" slug: "/guides/fine-tune" sidebar_position: 3 --- Super Protocol enables independent parties to jointly compute over their private inputs without revealing those inputs to one another. -This guide describes an example of confidential collaboration on Super Protocol: a fine-tuning of a pre-trained AI model. The scenario involves three parties: +This guide describes a scenario of confidential collaboration on Super Protocol. It uses fine-tuning of a pre-trained AI model as an example, but the general principle presented here may be applied to other cases. + +The scenario involves three parties: - **Alice** owns the AI model. - **Bob** owns the dataset. - **Carol** provides the training engine and scripts. -Neither Alice nor Bob is willing to share their intellectual property with other parties. At the same time, Carol must share her training engine and scripts with both parties so they can verify that the code is safe to run on their data. - -If Carol's training engine or scripts are proprietary and she cannot share them with Alice and Bob, a possible alternative is to involve independent security experts who can audit the code without exposing it publicly. +Neither Alice nor Bob is willing to share their intellectual property with other parties. At the same time, Carol must share her training engine and scripts with both parties so they can verify that the code is safe to run on their data. If Carol's training engine or scripts are proprietary and she cannot share them with Alice and Bob, a possible alternative is to involve independent security experts who can audit the code without exposing it publicly. The computation runs on Super Protocol within a Trusted Execution Environment that is isolated from all external access, including that of Alice, Bob, Carol, the hardware owner, and the Super Protocol team. Additionally, Super Protocol's Certification System provides verifiability, eliminating the need for trust. @@ -124,11 +124,11 @@ Both Alice and Bob can retrieve the order report ([12](/cli/guides/fine-tune#ali Keep in mind the special file structure inside the TEE: -| **Location** | **Purpose** | **Access** | -| :- | :- | :- | -| `/sp/inputs/input-0001`
`/sp/inputs/input-0002`
etc. | Possible data locations
(AI model, dataset, training scripts, etc.) | Read-only | -| `/sp/output` | Output directory for results | Write; read own files | -| `/sp/certs` | Contains the order certificate | Read-only | +| **Location** | **Purpose** | **Access** | +| :- | :- | :- | +| `/sp/inputs/input-0001`
`/sp/inputs/input-0002`
etc. | Possible data locations
(AI model, dataset, training scripts, etc.) | Read-only | +| `/sp/output` | Output directory for results | Read and write | +| `/sp/certs` | Contains the order certificate, private key, and workloadInfo | Read-only | Your solution must find the data in `/sp/inputs` and write the results to `/sp/output`. diff --git a/docs/cli/Guides/provider-tools.md b/docs/cli/Guides/provider-tools.md index b6cd6b72..3b18dd60 100644 --- a/docs/cli/Guides/provider-tools.md +++ b/docs/cli/Guides/provider-tools.md @@ -36,7 +36,7 @@ chmod +x ./provider-tools -## Set Up +## Set up ```shell ./provider-tools setup diff --git a/docs/cli/Guides/quick-guide.md b/docs/cli/Guides/quick-guide.md index 801e8523..0092c4a8 100644 --- a/docs/cli/Guides/quick-guide.md +++ b/docs/cli/Guides/quick-guide.md @@ -18,11 +18,11 @@ This quick guide provides instructions on deploying a TEE: -| **Location** | **Purpose** | **Access** | -| :- | :- | :- | -| `/sp/inputs/input-0001`
`/sp/inputs/input-0002`
etc. | Possible data locations | Read-only | -| `/sp/output` | Output directory for results | Write; read own files | -| `/sp/certs` | Contains the order certificate | Read-only | +| **Location** | **Purpose** | **Access** | +| :- | :- | :- | +| `/sp/inputs/input-0001`
`/sp/inputs/input-0002`
etc. | Possible data locations | Read-only | +| `/sp/output` | Output directory for results | Write; read own files | +| `/sp/certs` | Contains the order certificate, private key, and workloadInfo | Read-only | So, your solution must find the data in `/sp/inputs` and write the results to `/sp/output`. @@ -156,4 +156,8 @@ For example: ```shell ./spctl orders download-result 256587 -``` \ No newline at end of file +``` + +## Support + +If you have any issues or questions, contact Super Protocol on [Discord](https://discord.gg/superprotocol) or via the [contact form](https://superprotocol.zendesk.com/hc/en-us/requests/new). \ No newline at end of file diff --git a/docs/cli/index.md b/docs/cli/index.md index 39e44e41..c2d013d9 100644 --- a/docs/cli/index.md +++ b/docs/cli/index.md @@ -41,7 +41,7 @@ import TabItem from '@theme/TabItem'; You can also download and install SPCTL manually from the Super Protocol [GitHub repository](https://github.com/Super-Protocol/ctl). -## Set Up +## Set up You can set up SPCTL using the `./spctl setup` command or by manually creating a configuration file. @@ -103,7 +103,6 @@ You can set up SPCTL using the `./spctl setup` command or by manually creating a } } } - ``` 3. Do not change the preconfigured values and set values to the following keys: diff --git a/docs/guides/index.md b/docs/guides/index.md index 69d2473a..dd581766 100644 --- a/docs/guides/index.md +++ b/docs/guides/index.md @@ -7,18 +7,29 @@ sidebar_position: 0 ## Marketplace GUI -|
**Guide**
|
**Description**
| +|
**Guide**
|
**Description**
| | :- | :- | | [Log In with MetaMask](/marketplace/guides/log-in) | How to log in to the [Marketplace](https://marketplace.superprotocol.com/) using MetaMask. | | [Log In with Trust Wallet](/marketplace/guides/log-in-trustwallet) | How to log in to the Marketplace using Trust Wallet. | | [Deploy Your Model](/marketplace/guides/deploy-model) | How to upload and deploy an AI model on Super Protocol. | | [Publish an Offer](/marketplace/guides/publish-offer) | How to upload an AI model and publish it on the Marketplace. | -| [Prepare a ComfyUI Workflow](/marketplace/guides/prepare-comfyui) | How to prepare a ComfyUI workflow with custom nodes. | | [Set Up Personal Storage](/marketplace/guides/storage) | How to set up your personal Storj account. | | [Troubleshooting](/marketplace/guides/troubleshooting) | Most common issues and ways to fix them. | ## CLI -|
**Guide**
|
**Description**
| +|
**Guide**
|
**Description**
| +| :- | :- | +| [Configure SPCTL](/cli) | How to set up SPCTL—a Super Protocol CLI tool. | +| [Configure Provider Tools](/cli/guides/provider-tools) | How to set up Provider Tools—a Super Protocol CLI utility for registering providers and creating offers. | +| [Quick Deployment Guide](/cli/guides/quick-guide) | Quick instructions on deploying a solution and data on Super Protocol. | +| [Confidential Collaboration](/cli/guides/fine-tune) | A scenario of confidential collaboration on Super Protocol. | + +### Solutions + +|
**Guide**
|
**Description**
| | :- | :- | -| [Quick Deployment Guide](/cli/guides/quick-guide) | Quick instructions on deploying a solution and data on Super Protocol. | \ No newline at end of file +| [Text Generation WebUI](/cli/guides/solutions/tgwui) | How to deploy a model using Text Generation WebUI. | +| [ComfyUI](/cli/guides/solutions/comfyui) | How to prepare a ComfyUI workflow with custom nodes. | +| [Unsloth](/cli/guides/solutions/unsloth) | How to fine-tune an AI model using the Super Protocol packaging of Unsloth. | +| [vLLM](/cli/guides/solutions/vllm) | How to run a model inference using the Super Protocol packaging of vLLM. | \ No newline at end of file diff --git a/docs/marketplace/Guides/deploy-model.md b/docs/marketplace/Guides/deploy-model.md index f5b6a77e..d3b0b389 100644 --- a/docs/marketplace/Guides/deploy-model.md +++ b/docs/marketplace/Guides/deploy-model.md @@ -33,7 +33,7 @@ Ensure your model meets the Super Protocol requirements: - Text-to-Video - Mask Generation -If you plan to deploy a ComfyUI workflow with custom nodes, [prepare the files](/marketplace/guides/prepare-comfyui) before uploading. For security reasons, you cannot upload custom nodes directly to a deployed ComfyUI. +If you plan to deploy a ComfyUI workflow with custom nodes, [prepare the files](/cli/guides/solutions/comfyui) before uploading. For security reasons, you cannot upload custom nodes directly to a deployed ComfyUI. 1.2. Due to [testnet limitations](/marketplace/limitations), the total size of model files should not exceed 13 GB. Support for bigger models will be available in the future. From a44a4007005cdf9cc3f633fe2b546b95c712dfff Mon Sep 17 00:00:00 2001 From: k3dz0r Date: Thu, 11 Dec 2025 13:41:20 -0300 Subject: [PATCH 4/5] cli: add solutions guides --- docs/cli/Guides/collaboration.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/cli/Guides/collaboration.md b/docs/cli/Guides/collaboration.md index b6540bab..5c593118 100644 --- a/docs/cli/Guides/collaboration.md +++ b/docs/cli/Guides/collaboration.md @@ -48,9 +48,10 @@ sequenceDiagram Super Protocol / TEE ->> Super Protocol / TEE: Process the order Super Protocol / TEE ->>- Storage: Upload the order results Alice ->> Storage: 10. Download the order results + end + Alice ->> Blockchain: 11. Get the order report Bob ->> Blockchain: 11. Get the order report - end ```
From a5020f560ffd32c2b7b374e88b16f53e0451dba6 Mon Sep 17 00:00:00 2001 From: k3dz0r Date: Mon, 5 Jan 2026 11:21:59 -0300 Subject: [PATCH 5/5] whitepaper and cli-tgwui guide hidden --- docs/cli/Guides/Solutions/tgwui.md | 2 ++ docs/fundamentals/certification.md | 2 +- docusaurus.config.js | 6 +++--- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/cli/Guides/Solutions/tgwui.md b/docs/cli/Guides/Solutions/tgwui.md index d6ce3bb0..ca7c461b 100644 --- a/docs/cli/Guides/Solutions/tgwui.md +++ b/docs/cli/Guides/Solutions/tgwui.md @@ -3,4 +3,6 @@ id: "tgwui" title: "Text Generation WebUI" slug: "/guides/solutions/tgwui" sidebar_position: 1 +displayed_sidebar: null +unlisted: true --- \ No newline at end of file diff --git a/docs/fundamentals/certification.md b/docs/fundamentals/certification.md index 611d5375..a943c6b5 100644 --- a/docs/fundamentals/certification.md +++ b/docs/fundamentals/certification.md @@ -25,7 +25,7 @@ The SubRoot CAs, in turn, issue and sign certificates for