Module: Funds
Purpose: This guide explains how to create and manage funds in the admin panel. Each record defines a specific investment opportunity, including its financial terms, general description, and current status.
Key Connections:
Each fund is funded by multiple investment records.
Its on-chain behavior is configured via the EVM Contracts module.
The List View: Finding & Managing Funds
The main list view provides the following features.
- Key Columns: The list view provides an at-a-glance summary. Pay attention to the
Statuscolumn, which shows a fund's current status, and theSubscriptionscolumn, which shows how close it is to its goal.
Opening an Offer record shows its Detail View, where the RWA lifecycle is managed through the Header, Summary Block, and Tabbed Navigation.
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, this shows you where you are in the admin panel and allows you to navigate back to the main list.
Create another fund (top-right plus icon): Select the plus icon to create another fund.
The Fund Summary Block
This block provides an immediate, at-a-glance summary of the fund's most critical information.
- Avatar & Name
- Status of Fund'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 fund is to reaching its funding goal.
- Action Menu (Three Dots): This menu contains important, high-level actions that are specific to this fund. This includes a link to the fund's wallet on the Electronic Wallet Provider side.
Tabbed Navigation
All of the fund'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 fund.
| Title | Description | Mandatory? | Locked in Published State? | Represented on Frontend? |
|---|---|---|---|---|
| Name | The public-facing display name for the fund, 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 represented by the fund. | Yes | No | No |
| Title | The public-facing display title for the fund, shown to investors on the website. | Yes | No | Yes (TBD) |
| Officer | The admin or legal officer responsible for validating and managing this fund. | Yes | No | No |
| Created at | A read-only timestamp indicating when the fund record was first created. | System | System | No |
| Updated at | A read-only timestamp indicating when the fund 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 fund. | Yes | Yes | Yes |
| Price per share | The price for a single share or token in the fund. | 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 fund is conducted (e.g., Reg A, Reg D). | Yes | Yes | Yes |
| Close at | The approximate date and time when the fund 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 fund. 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 fund. 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 fund.
Key Functionality
Folder Structure: The system uses a pre-defined folder structure to ensure documents are organized consistently across all funds.
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.
Folder Access Control: Administrators can assign viewing rights for each folder to 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 fund 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 fund'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 fund. | 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 fund 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 fund page. | Yes | No | Yes |
| Highlights | Key bullet points or selling features of the fund, 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 fund. 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 fund. 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 | The name of the bank where investor funds should be wired. | Yes | Yes | Conditional |
| Investment SWIFT ID | The SWIFT/BIC code for the receiving bank for international wires. | Yes | Yes | Conditional |
| Investment Custodian Name | The name of the official third-party custodian holding the asset or funds. | Yes | Yes | Yes |
| Investment Account Number | The account number for receiving investment funds. | Yes | Yes | Conditional |
| Investment Routing Number | 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 fund's journey from creation to closure. It acts as a guide for administrators, showing the current stage of the fund and highlighting any required information or actions needed to advance to the next phase.
Fund Stages
Below is a description of each stage in the fund's lifecycle as shown in the timeline.
Initial creation: The basic fund record is created with its primary details in the General tab.
Information and document preparation: Before a fund 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.
Legal review: The fund has been submitted to compliance for due diligence. At this stage, most fund fields are locked to prevent changes during the review process.
Review returned for changes: The compliance side has rejected the fund. The administrator must review the provided feedback in logs format, correct the highlighted issues, and then resubmit the fund for review.
Approval for publication: The compliance team has approved the fund's structure, documentation, and details. It is now unlocked and ready for the administrator to publish.
Publication: The fund is live on the platform, visible to all eligible investors, and is actively accepting investments.
Investment window closed: The investment window has ended (e.g., the "Close at" date has passed) or the fund was closed with a 100% funded event, and the fund is no longer accepting new investments.
Successful close and servicing: The fund has met or exceeded its funding goal and all closing procedures are complete. The asset is now officially funded and under management.
Unsuccessful close: The fund 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 lists the investment commitments associated with the fund. Administrators can inspect each record's status, payment method, and financial details.
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: Use the sidebar on the right to narrow the list by date range or Investment 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 lists money movements associated with the fund. It shows transfers from Investor Electronic wallets to destination wallets and the current 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: Use the sidebar on the right to isolate transactions by 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 shows the fund's contract data and token transfers. Administrators can compare these records with the platform's off-chain fund records.
This tab is organized into two main sections: the contract's static details and a dynamic log of all its transfers.
Smart Contract Details
The top panel 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 fund.
Tab: EVM Transfers
This is a real-time list of all on-chain transactions involving the fund'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 fund. Its primary function is for compliance and internal auditing, answering the question: "Who changed what data on this fund, and when?"
This tab typically displays a list of entries, where each entry represents a saved change to the fund. 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 fund. 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 fund. It aggregates key activities from associated modules (Investments, Profiles, etc.) into a single, chronological feed.