Module: Offers
Purpose: The Offers module is the central hub for creating and managing the digital representation of a RWA. Each record in this module defines a specific investment opportunity, including its financial terms, general description, and current status.
Key Connections:
Each offer is funded by multiple investment records.
Its on-chain behavior is configured via the EVM Contracts module.
The List View: Finding & Managing Offers
This section details the unique features of the module's main list view.
Key Columns: The list view provides an at-a-glance summary. Pay attention to the
Statuscolumn, which shows an offer's current status, and theSubscriptionscolumn, which shows how close it is to its goal.Useful Filters: To find specific information quickly, use the filters on the right. The most common filter is by Status, allowing you to see all
Publishedoffers that are currently open for investment.
The Detail View: The Offer Command Center
When you open an Offer record, you are taken to its Detail View. This page is more than just a form; it's a command center for managing the entire lifecycle of that specific RWA. It is organized into three main areas: the Header, the Summary Block, and the detailed information Module-Offers.
Header & Global Actions
At the very top of the page, you'll find navigation and key actions:
Breadcrumb Navigation: Located just below the main title (e.g.,
Home > Offer > Offers > <Offer's name>), this shows you exactly where you are in the admin panel and allows you to quickly navigate back to the main list.Add Offer (+ Icon) (Top Right): A quick link to create another new offer.
The Offer Summary Block
This block provides an immediate, at-a-glance summary of the offer's most critical information.
- Avatar & Name
- Status of Offer's Wallet on Electronic Wallet Provider side.
- Key Metrics: You can instantly see the Minimum Investment, the Total Shares/Value, the current Status, and the responsible Officer/Admin.
- Funding Progress Bar: The "Filled" progress bar gives you a real-time visual representation of how close the offer is to reaching its funding goal.
- Action Menu (Three Dots): This menu contains important, high-level actions that are specific to this offer. This includes link to Offer's Wallet on Electronic Wallet Provider side.
Tabbed Navigation
All of the offer's detailed data points, settings, and related information are organized into a series of tabs below the summary block (e.g., General, Finance, Files, E-Sign, Legal, Investments, On-Chain, Logs,** etc.). This keeps the information organized and easy to navigate.
The next section provides a field-by-field guide to the information found within these tabs.
Tab: General
The General tab contains the primary administrative and identifying details for the offer.
| Title | Description | Mandatory? | Locked in Published State? | Represented on Frontend? |
|---|---|---|---|---|
| Name | The public-facing display name for the offer, shown to investors on the website. | Yes | No | Yes |
| Slug | The URL-friendly version of the name. Auto-generated but can be edited. | Yes | No | URL |
| Legal name | The full, official legal name of the entity or asset being offered. | Yes | No | No |
| Title | The public-facing display title for the offer, shown to investors on the website. | Yes | No | Yes (TBD) |
| Officer | The admin or legal officer responsible for validating and managing this offer. | Yes | No | No |
| Created at | A read-only timestamp indicating when the offer record was first created. | System | System | No |
| Updated at | A read-only timestamp indicating when the offer was last modified. | System | System | No |
Tab: Finance
The Finance tab is used to define all financial parameters of the investment opportunity. This includes setting the minimum investment, price per share/token, funding goal, pre-money valuation, price per share, and specifying the key terms of the security type.
| Title | Description | Mandatory? | Locked in Published State? | Represented on Frontend? |
|---|---|---|---|---|
| Subscribed shares | A read-only field showing the total number of shares investors have committed to purchasing. | Yes | Yes | Yes |
| Confirmed shares | A read-only field showing the total number of shares that have been fully paid for. | Yes | Yes | No |
| Min investment | The minimum value or number of shares an investor is required to purchase. | Yes | Yes | Yes |
| Total shares | The total number of shares or tokens being made available for purchase in this offer. | Yes | Yes | Yes |
| Price per share | The price for a single share or token in the offering. | Yes | Yes | Yes |
| Security type | The legal classification of the investment instrument (e.g., preferred equity, common equity, debt). This choice determines which additional fields are shown. | Yes | Yes | Yes |
| Reg type | The regulatory framework or exemption under which the offer is conducted (e.g., Reg A, Reg D). | Yes | Yes | Yes |
| Close at | The approximate date and time when the offering will close. | Yes | Yes | Yes |
| Liquidation Preference | A term defining the payout order in a liquidation event (e.g., 1x, 2x participating). Collected when Security Type is "Preferred Equity". | Yes | Yes | Yes |
| Dividend Type | The method by which dividends or returns will be paid. Collected when Security Type is "Preferred Equity". | Yes | Yes | Yes |
| Pre-Money Valuation | The valuation of the company or asset before this investment round is included. Collected when Security Type is "Common Equity" / "Preferred Equity". | Yes | Yes (TBD) | Yes |
| Funding Goal | The total target amount of capital to be raised for this offer. Collected when Security Type is "Debt" / "Convertible Note". | Yes | Yes (TBD) | Yes |
| Voting rights | Defines the shareholder's power in corporate governance (e.g., one_vote_per_share, non-voting). Collected when Security Type is "Common Equity". | Yes | Yes | Yes |
| Interest Rate (APY %) | The Annual Percentage Yield (APY) that will be paid to the debt holders. Collected when Security Type is "Debt" / "Convertible Note". | Yes | Yes | Yes |
| Payment Schedule | The frequency of interest payments (e.g., interest_only_quarterly, monthly). Collected when Security Type is "Debt". | Yes | Yes | Yes |
| Term Length | The duration of the loan before the principal is due. Collected when Security Type is "Debt". | Yes | Yes | Yes |
| Term Unit | The unit of time for the term length (e.g., months, years). Collected when Security Type is "Convertible Note". | Yes | Yes | Yes |
| Maturity Date | The specific date on which the loan matures and the principal must be repaid. Auto-calculated or manual. Collected when Security Type is "Debt" / "Convertible Note". | Yes | Yes | Yes |
| Valuation Cap | The maximum company valuation at which the note will convert into equity, providing a price ceiling for the investor. Collected when Security Type is "Convertible Note". | Yes | Yes | Yes |
| Discount Rate (%) | A discount applied to the future valuation that note holders receive when their investment converts to equity. Collected when Security Type is "Convertible Note". | No | Yes | Yes |
| Targeted IRR | The projected Internal Rate of Return that the investment aims to generate for investors. Collected when Security Type is "LLC Membership Units". | No | No | Yes |
| Targeted Equity Multiple | The projected total return on investment, expressed as a multiple of the initial capital. Collected when Security Type is "LLC Membership Units". | No | No | Yes |
| Targeted Cash-on-Cash | The projected annual pre-tax cash flow as a percentage of the total cash invested. Collected when Security Type is "LLC Membership Units". | No | No | Yes |
| Property Type | For real estate assets, specifies the category of the property. Collected when Security Type is "LLC Membership Units". | No | Yes | Yes |
| Distribution Waterfall | A detailed, mandatory description of the legal and financial structure defining the order in which profits are distributed to investors and the sponsor. Collected when Security Type is "LLC Membership Units". | Yes | Yes | Yes |
| Repayment Multiple | The total amount the investor is entitled to receive, expressed as a multiple of their initial investment (e.g., 2x). Collected when Security Type is "RevShare". | Yes | Yes | Yes |
| Revenue Share % | The percentage of the company's gross revenue allocated to the investor repayment pool. Collected when Security Type is "RevShare". | Yes | Yes | Yes |
| Projected Term | An estimated timeframe (e.g., 36 Months) for the investor to receive their full repayment multiple. Collected when Security Type is "RevShare". | No | No | Yes |
| Valuation Cap | The maximum company valuation at which the SAFE note converts into equity during a future financing round. Collected when Security Type is "SAFE". | Yes | Yes | Yes |
| Discount Rate | An optional discount applied to the future valuation for SAFE holders when their investment converts to equity. Collected when Security Type is "SAFE". | No | Yes | Yes |
Tab: Files
This tab provides a centralized file management system for all documents related to the offer. It is used to store and organize critical files such as legal agreements, marketing media, investor updates, and tax documents, ensuring all necessary documentation is associated with its specific offering.
Key Functionality
Folder Structure: The system uses a pre-defined folder structure to ensure documents are organized consistently across all offers.
Uploading & Management: Administrators can upload and manage files within the appropriate folders.
Search: The search bar allows you to quickly find specific files by name.
Granular Access Control: The system includes a powerful permission model, allowing administrators to control access to each folder individually. For each folder, you can set specific viewing rights for different user groups, such as:
Anonymous Users: Can be granted access to public-facing folders like
media.Investors: Once logged in, can access folders relevant to them, like
investment-agreementsorinvestor-updates.Authorized Users (Admins/Officers/Compliance): Have full access to all folders, including sensitive internal documents in the
companyortaxfolders.
Folder View & Uploading
When you click on a folder, you enter the Folder View.
Navigation: You can always see your current location and navigate back using the breadcrumb trail at the top (e.g.,
DOCUMENTS > INVESTMENT-AGREEMENTS).File List: Any files that have been uploaded to this folder will be displayed in a list, showing details like the file name, size, and date modified.
Uploading New Files: To add a new file to the selected folder, you have two options:
Drag and drop the file directly from your computer onto the designated upload area.
Click the Upload button to open your computer's file browser and select the file(s) you wish to add.
Default Folder Structure
| Folder Name | Purpose & Description | Example Documents |
|---|---|---|
| company | Contains legal and formation documents for the sponsoring company or created for the asset. | Certificate of Incorporation, Operating Agreement, Bylaws |
| investment-agreements | Stores all legal contracts and disclosures that investors will need to review and sign. | Subscription Agreement, Private Placement Memorandum (PPM) |
| media | A repository for all marketing and promotional materials that are displayed on the public-facing offer page. | Pitch Deck, Property Photos, Logos |
| other | A general-purpose folder for any documents that do not fit into the other specific categories. | Quarterly Investor Updates, Market Research Reports, Appraisals |
| tax | Used to store all tax-related documentation for the investment, which may be distributed to investors post-investment. | K-1 Schedules, Tax Filings |
Tab: E-Sign
The E-sign tab is where the electronic signature process for the offer's legal documents is configured and managed.
This includes selecting the subscription agreement template and tracking the signature status for all participating investors (TBD).
| Title | Description | Mandatory? | Locked in Published State? | Represented on Frontend? |
|---|---|---|---|---|
| Esign id | The unique identifier for the electronic signature template associated with this offer. | Yes | Yes | No |
| Link to template | Link to template on E-signature provider side. | Yes | Yes | No |
Tab: SEO
This tab is used to manage all the public-facing content, search engine optimization (SEO) metadata, and social media links for the offer page.
| Title | Description | Mandatory? | Locked in Published State? | Represented on Frontend? |
|---|---|---|---|---|
| Description | The primary, detailed marketing description of the RWA and investment opportunity, displayed on the offer page. | Yes | No | Yes |
| Highlights | Key bullet points or selling features of the offer, often displayed in a prominent summary section on the page. | Yes | No | Yes |
| Additional details | A field for supplementary information or fine print that doesn't fit in the main description. | No | No | Yes |
| Notes | Internal-only notes for administrators regarding this offer. This field is never visible to the public. | No | No | No |
| Seo title | The text that will appear in the browser tab and as the main headline in search engine results. | No | No | Yes (in HTML <title> tag) |
| Seo description | The short summary (~160 characters) that appears under the title in search engine results. | No | No | Yes (in HTML <meta> tag) |
| Social Links | A series of fields for links to social media pages related to the asset or sponsor. | No | No | Yes (as icons/links) |
Tab: Legal
This tab is used to configure the core legal and structural details of the offering. It includes information about the investment strategy, banking details for receiving funds, and the official legal address of the sponsoring entity.
| Title | Description | Mandatory? | Locked in Published State? | Represented on Frontend? |
|---|---|---|---|---|
| Video iFrame | The HTML embed code for a marketing or informational video about the asset. | No | No | Yes |
| --- Banking & Custodian Information --- | --- | --- | --- | --- |
Investment Wire Bank<to remove> | The name of the bank where investor funds should be wired. | Yes | Yes | Conditional |
Investment SWIFT ID<to remove> | The SWIFT/BIC code for the receiving bank for international wires. | Yes | Yes | Conditional |
Investment Custodian Name<to remove> | The name of the official third-party custodian holding the asset or funds. | Yes | Yes | Yes |
Investment Account Number<to remove> | The account number for receiving investment funds. | Yes | Yes | Conditional |
Investment Routing Number<to remove> | The ABA routing number for the receiving bank. | Yes | Yes | Conditional |
| --- Legal Entity Address --- | --- | --- | --- | --- |
| Country | The legal country of registration for the sponsoring entity. | Yes | Yes | No |
| State | The legal state of registration for the sponsoring entity. | Yes | Yes | No |
| City | The legal city for the sponsoring entity's address. | No | Yes | No |
| Zip code | The legal postal code for the sponsoring entity's address. | No | Yes | No |
| Address1 / Address2 | The legal street address for the sponsoring entity. | Yes | Yes | No |
| Website | The official website of the sponsoring entity or asset. | No | No | Yes (TBD) |
Tab: Lifecycle
The Lifecycle tab provides a visual timeline and checklist of the offer's journey from creation to closure. It acts as a guide for administrators, showing the current stage of the offer and highlighting any required information or actions needed to advance to the next phase.
Offer Stages
Below is a description of each stage in the offer's lifecycle as shown in the timeline.
Create offer This is the initial stage where the basic
Offerrecord is created with its primary details in the General tab.Upload docs, media files and other required info Before an offer can be submitted for review, all mandatory fields across all tabs must be completed and all required documents must be uploaded. This stage will display a list of any missing information that is blocking progress.
Offer on legal review The offer has been submitted to the compliance for due diligence. At this stage, most offer fields are locked to prevent changes during the review process.
Legal review failed The compliance side has rejected the offer. The administrator must review the provided feedback in logs format, correct the highlighted issues, and then resubmit the offer for review.
Legally approved The compliance team has approved the offer's structure, documentation, and details. It is now unlocked and ready for the administrator to publish.
Offer is published The offer is live on the platform, visible to all eligible investors, and is actively accepting investments.
Legally closed The investment window has ended (e.g., the "Close at" date has passed) or the offer was closed with 100% funded event, and the offer is no longer accepting new investments.
Successfully closed(Servicing) The offer has met or exceeded its funding goal and all closing procedures are complete. The asset is now officially funded and under management.
Unsuccessfully closed The offer did not meet its funding goal within the specified timeframe. The process to return all committed funds to investors is initiated.
Tab: Investments
The Investments tab provides a comprehensive list of every individual investment commitment made to this specific offer. It serves as a detailed ledger, allowing administrators to track the status, payment method, and financial details of each transaction from every investor involved in the offering.
Key Features
Search: Use the "Type to search" bar at the top to quickly find a specific investment. You can typically search by investor name, email, or a unique ID.
Filtering: The sidebar on the right provides powerful tools to narrow down the list based on date ranges or, most importantly, the investment's current status.
Column Descriptions
The list provides the following information for each investment record:
| Column Title | Description |
|---|---|
| ID | The unique identifier for the specific investment record. |
| Amount | The monetary value of the investment and the corresponding number of shares/units purchased. |
| Step | The current stage of the investment within the internal workflow (e.g., review). |
| Payment type | The payment gateway or method used by the investor (e.g., dwolla, wire). |
| Funding type | The method by which the funds are being handled within the system (e.g., wallet, wire). |
| Funding Status | The status of the payment transfer itself (e.g., initialize, cleared, failed). |
| Status | The overall legal and business status of the investment. This is the most critical column for tracking progress. |
| Created at | The date and time when the investor initiated the investment. |
| Updated at | The date and time when the investment record was last modified. |
Filtering Options
By Updated at: This allows you to view investments that were modified within a specific timeframe, such as
Today,Past 7 days, orThis month. This is useful for reviewing recent activity.By Status: This is the primary tool for managing investments. It allows you to isolate records based on their current stage in the lifecycle.
Tab: Transactions
The Transactions tab provides a comprehensive and immutable financial ledger of money movements associated with this specific offer. It serves as the primary audit trail for tracking the flow of funds from investor Electronic wallets to the offer's destination wallets, showing the real-time status of each payment.
Key Features
Search: The search bar allows you to find specific transactions, likely by wallet address, amount, or transaction ID.
Filtering: The sidebar on the right is crucial for financial operations, allowing you to isolate transactions based on their current processing status.
Column Descriptions
The list provides the following information for each transaction record:
| Column Title | Description |
|---|---|
| ID | The unique identifier for the transaction record in the system. |
| Source wallet | The wallet address (internal ID) from which the funds were sent. |
| Dest wallet | The destination wallet address. |
| Amount | The exact monetary value of the transaction. |
| Status | The real-time processing state of the transaction. This is the most critical column for tracking financial operations. |
| Created at | The date and time the transaction was initiated. |
Filtering Options
By Status: This filter is essential for reconciliation and monitoring. It allows you to view transactions based on their current state:
wait: The transaction is awaiting confirmation or the next step in the process.
pending: The transaction has been initiated but is not yet complete (e.g., awaiting blockchain confirmation).
processed: The transaction has been successfully completed, and funds have been settled.
failed: The transaction did not complete due to an error.
cancelled: The transaction was cancelled before completion.
Tab: On-Chain
The On-Chain tab provides a direct view of all blockchain activities and data associated with this specific RWA token offering. It acts as the bridge between the platform's off-chain records and the on-chain reality, offering transparency and a verifiable audit trail for all token-related movements.
This tab is organized into two main sections: the contract's static details and a dynamic log of all its transfers.
Smart Contract Details
This section at the top displays the foundational on-chain information for the offer.
Smart Contract Address: The unique blockchain address of the smart contract that governs this specific RWA token. This address is a clickable link that opens a block explorer for independent verification.Token Standard: The technical standard of the token (e.g., ERC-3643), which defines its compliance features and capabilities.Total Supply: The total number of tokens that have been minted by the smart contract for this offer.
Tab: EVM Transfers
This is a real-time list of all on-chain transactions involving the offer's tokens.
| Column Title | Description |
|---|---|
| Transaction Hash (TxHash) | The unique ID of the blockchain transaction. This is a link that opens the specific transaction in a block explorer. |
| Event/Method | The type of on-chain action that occurred (e.g., Mint, Transfer, Distribution, Redemption). |
| From Address | The sender's wallet address. For token issuance, this may be the "zero address". |
| To Address | The recipient's wallet address. |
| Amount/Tokens | The number of tokens that were transferred in the transaction. |
| Timestamp | The date and time the transaction was successfully confirmed on the blockchain. |
Tab: History
The History tab provides a detailed and immutable audit trail of every change made to the Offer record itself. Its primary function is for compliance and internal auditing, answering the question: "Who changed what data on this offer, and when?"
This tab typically displays a list of entries, where each entry represents a saved change to the offer. Each entry would show:
Date/Time: The exact timestamp of the change.
User: The administrator who made the change or the investor.
Action: The type of change.
Fields Changed: A summary of which specific fields were modified and their new values.
Tab: Logs
The Logs tab is a more technical view intended for administrators and developers. It displays low-level system and application logs related to this specific offer. Unlike History, which tracks user-driven data changes, Logs tracks automated processes, API interactions, and system events.
This would be a feed of technical log entries, typically including:
Timestamp: The precise time the event occurred.
Service: The part of the system that generated the log.
Message: The detailed log message itself.
Tab: Activity
The Activity tab provides a high-level, human-readable timeline of all significant business events related to the offer. It aggregates key activities from associated modules (Investments, Profiles, etc.) into a single, chronological feed.