- -###### Lock is a feature that allows clients and providers to lock the funds deposited into their smart invoice, triggering arbitration. - -###### If the client loses confidence in the provider at any time or the provider under delivers on their promise, the client may lock any remaining funds in smart invoice so they cannot be released or withdrawn. - -###### Alternatively, if the client has not released funds after a milestone is complete, the provider may lock any remaining funds in smart invoice. - -
- -###### Arbitration is triggered by either the client or provider locking funds held by their smart invoice. Arbitration is the process of resolving a dispute between a client and a provider, and it is facilitated by a third-party adjudicator. - -
- -###### Lock triggers the arbitration provider (i.e., LexDAO or Custom) to review and resolve the dispute. - -###### Based on their review, the arbitration provider will determine which party should receive "x" amount of funds, and will send a transaction to smart invoice that transfers the appropriate amount to each party. - -
- -###### Deposit is a function that allows the client to deposit funds into the milestone(s), and before or after the milestone is completed, the client can use the release function to release the funds to the provider for their service. In order to release funds, the client must first make a deposit! - -
- -###### In order to release or withdraw your payment, first you will want to navigate to "view existing invoice" and check the status shown in the right column next to your smart invoice. If the status of your smart invoice shows: - -1. Awaiting deposit - this means you need to make a deposit, following your deposit you will be able to release payment -2. In dispute - You will not be able to release/withdraw payment until the dispute is resolved -3. Safety valve withdrawal date passed - -
- -###### Yes, you can execute one transaction for all milestone deposits and releases respectivley. - -
- -1. Awaiting Deposit -2. Funded -3. Completed -4. Expired -5. In dispute - -
- -1. Ethereum Mainnet -2. Gnosis Chain -3. Polygon - -
- -###### Project Name or ID - The name of your project - -###### Link to Project Agreement - Link to supporting documents or website - -###### Project Description - This acts as a brief explainer for your project - -###### Project Start / End / Safety Valve - These are the dates you will start, finish, and allow the client to withdraw all funds by. - -
- -###### Safety Valve is a built in function that allows the client to withdraw funds from the contract on the date specified in the date entry field. This can be a useful feature in the scenario that a provider goes unresponsive or bails on the project, in which case the client can withdraw all funds deposited into smart invoice on or after the Safety Valve date. - -
- -###### Client Address - Address the client will use to send funds to smart invoice - -###### Service Provider Address - Address the provider will use to receive funds from smart invoice - -###### Total Payment Due - Total amount your requesting for completing the project - -###### Payment Token - The token you wish to accept payment in - -###### Number of Payments - The count of payments broken down by milestone - -###### Arbitration Provider - This is the third party adjudicator responsible for providing a resoution if a dispute is raised - -###### Max Dispute Fee - This is the maximum fee the arbitration provider will charge on the remaining funds held in smart invoice - -###### Terms-of-Service - An agreement outlining the usage of the arbitration provider - -
- -###### Lock triggers the arbitration provider (i.e., LexDAO or Custom) to review and resolve the dispute. - -###### Based on their review, the arbitration provider will determine which party should receive "x" amount of funds, and will send a transaction to smart invoice that transfers the appropriate amount to each party. - -
- -##### An example of two parties using Smart Invoice could be a service provider and a consumer/client who want: - -###### 1. Streamlined Experience: A simple interface to create and view payments - -###### 2. Information Access: Reliable, auditable, and immutable information flows - -###### 3. Contractual Enforcement: Serviced through Impartial third-party dispute resolution - -
- {description}
-{siteConfig.tagline}
-
+
+
+## Arbitration Process
+
+1. A conflict arises between two SmartInvoice users, who have chosen a custom arbitration provider. One of the parties locks the funds in the Smart Invoice escrow by calling the `lock()`.
+2. The user locking the funds is prompted to complete a form detailing the reason for the claim, a justification, and evidence.
+3. After `lock()` was called, the funds are forwarded to the smart contract specified upon signup.
+4. The specified smart contract, acting as arbitrator, receives the funds.
+5. The form is publicly available through an IPFS hash.
+6. An operator, controlling the smart contract acting as arbitrator SHALL review the information provided in the document on IPFS, which are associated with the contested SmartInvoice escrow.
+7. Based on the information provided, an operator controlling the smart contract acting as custom arbitration provider, SHALL make a ruling and release the funds accordingly.
+
+## Fees
+
+SmartInvoice cannot provide any information on the fees that are incurred when choosing a custom arbitration provider as SmartInvoice has neither control over the provider used, nor knowledge of which provider is being used.
+
+## Specification
+
+SmartInvoice cannot provide any details on the arbitration architecture and safeguards in place, when choosing a custom arbitration provider.
+
+## Terms
+
+**Disclaimer Regarding the Selection of Custom Arbitration Arbitrators**
+
+In the event of a user (hereinafter “the User”) choosing a custom arbitration provider for [smartinvoice.xyz](https://smartinvoice.xyz) (hereinafter referred to as "Custom Arbitrator") instead of a pre-approved arbitration providers endorsed by [smartinvoice.xyz](https://smartinvoice.xyz), such as LexDAO or Kleros, the User assumes full and exclusive responsibility for the selection, engagement, and outcomes associated with the use of said Custom Arbitrator. The User, hereby, agrees and acknowledges that SmartInvoice.xyz, its affiliates, representatives, agents, advisors (collectively, "SmartInvoice.xyz") SHALL bear no liability, whether direct, indirect, incidental, special, punitive, consequential, or otherwise, for any and all claims, damages, losses, expenses, costs, obligations, or liabilities, including but not limited to legal fees, arising out of, related to, or in connection with the User's decision to utilise a Custom Arbitrator for arbitration purposes.
+
+The User acknowledges and agrees that SmartInvoice.xyz provides no warranties, express or implied, as to the suitability, legality, reliability, quality, integrity, or availability of any Custom Arbitrator selected by the User. Furthermore, the User explicitly absolves SmartInvoice.xyz from any responsibility for the acts, omissions, decisions, or outcomes produced by the Custom Arbitrator, including but not limited to the resolution of disputes, the handling of any funds in escrow, and the enforcement of any arbitration awards.
+
+By choosing a Custom Arbitrator, the User confirms their understanding of and agreement to the fact that SmartInvoice.xyz's provision of its platform and related services does not extend to the vetting, approval, or endorsement of any Custom Arbitrator. The user further agrees that the use of a Custom Arbitrator SHALL be governed entirely by the terms and conditions, rules, and procedures established by such Custom Arbitrator, and that any recourse for dissatisfaction or dispute with a Custom Arbitrator shall lie solely against the Custom Arbitrator and not SmartInvoice.xyz.
+
+**Indemnification Clause**
+
+The User hereby agrees to indemnify, defend, and hold harmless SmartInvoice.xyz from and against any and all claims, damages, liabilities, costs, and expenses, including reasonable attorneys’ fees and costs, arising out of or in any way connected with the User’s selection, engagement, and use of a Custom Arbitrator, or the User’s breach of any representation, warranty, or covenant under this disclaimer or the terms and conditions of SmartInvoice.xyz. This indemnification obligation will survive the termination or expiration of the User’s use of SmartInvoice.xyz and/or the selection of a Custom Arbitrator.
+
+**Severability Clause**
+
+If any provision of this disclaimer, or the application thereof to any person or circumstance, is found to be invalid, void, or unenforceable to any extent, such invalidity, voidness, or unenforceability shall not affect the remaining provisions hereof, and the application of such provision to other persons or circumstances, which shall enforce to the fullest extent permitted by law. The parties hereby agree to replace any invalid, void, or unenforceable provision with a valid and enforceable provision that most closely matches the intent of the original provision. The remaining provisions of this disclaimer shall continue in full force and effect.
\ No newline at end of file
diff --git a/packages/website/docs-v3/arbitration/kleros-arbitration.md b/packages/website/docs-v3/arbitration/kleros-arbitration.md
new file mode 100644
index 00000000..5f309809
--- /dev/null
+++ b/packages/website/docs-v3/arbitration/kleros-arbitration.md
@@ -0,0 +1,135 @@
+---
+title: Kleros Arbitration Policy
+---
+
+## Introduction
+
+Smart Invoice is committed to providing resilient and flexible arbitration solutions that satisfy institutional needs, as well as cost-effective alternatives for users working as freelancers or use Smart Invoice for small sums only. Our partnership with [Kleros](https://kleros.io) helps us to deliver on our objectives for chains. Kleros is a trialled and tested solution that allows Smart Invoice users with small to medium sized invoices, with a minimum value of USD 1,000 at the time of the dispute, a reliable option for settling their disputes. Should your invoice fall below the threshold value at the time of dispute, the arbitration is handled internally by Smart Invoice. Please refer to *Arbitration by Smart Invoice* for reference. Smart Invoice is handling the collection of further information on claims and executes the decision made by Kleros through a [HATs Signer Gate-protected](https://hats-signer-gate-portal.vercel.app/deploy/hsgws) multi-sig wallet.
+
+Smart Invoice is Kleros recognised jurisdictions, which means that you will have to provide information about your claim to Smart Invoice, using a [Google Form](https://forms.gle/K3oMAzAb32G5SbpM9). We will then share the information with the responsible Kleros Court. After a decision was made, Smart Invoice shares the result with the disputants and releases the funds. In that process, you have the ability to appeal twice if your invoice exceeds a value of USD 2,000. In the following, the arbitration process, detailed conditions for enforcement and escalation, our arbitration policy, the court parameters, and the Kleros integration type are described. Finally, this documents references the multi-sig addresses for executing the arbitration, the fees, and the arbitration interface.
+
+## *Kleros* Arbitration Process
+
+1. A conflict arises between two Smart Invoice users, who have chosen Kleros as arbitration provider. One of the parties locks the funds in the Smart Invoice escrow by calling the `lock()` function.
+2. The user locking the funds is prompted to complete a form detailing the reason for the claim, a justification, and evidence.
+3. After `lock()` was called, the funds are forwarded to a three out of five signers multi-signature wallet controlled by Smart Invoice representatives.
+4. Kleros receives both forms and automatically converts them into a document that is easy for the jurors to read.
+5. Kleros initiates the dispute in the appropriate court and uploads the statements from both parties. Then the Kleros court takes over the dispute and resolves it in four stages.
+ 1. Evidence - Evidence can be submitted and parties can withdraw.
+ 2. Vote - Jurors reveal/cast their vote.
+ 3. Appeal - The dispute can be appealed.
+ 4. Execution - Tokens are redistributed, and the ruling is executed.
+6. Kleros informs Smart Invoice of the case resolution, and the Smart Invoice representatives execute the multi-sig accordingly.
+
+### Submission of Evidence
+
+The evidence you are submitting to the Kleros Court consists of the following:
+- Smart Invoice data, including the project description, linked project specification
+- additional information you are providing through the [Google form](https://forms.gle/K3oMAzAb32G5SbpM9)
+- a claim statement collected from you when locking the funds
+
+Please note that all evidence must be provided through the forms provided on [smartinvoice.xyz](https://smartinvoice.xyz)to be admitted to the arbitration process. **Failing to provide relevant information in the project description and through the forms will lead to its exclusion in the arbitration process.** It is your sole responsibility to provide all necessary information. Providing additional information when locking the funds shall be done through this [Google form](https://forms.gle/K3oMAzAb32G5SbpM9).
+
+For a project description that is linked to an escrow account on SmartInvoice upon creation, to be valid and considered as evidence by Kleros, the project description must be available as tamperproof and non-repudiable document. That may be a linked document that was signed using DocuSign, an IPFS hash, or similar. Otherwise, you will have to submit evidence in the [Google Form for claim submissions](https://forms.gle/K3oMAzAb32G5SbpM9) that irrefutably proofs that the version of the document linked in the escrow description matches the version and document that was agreed upon by both parties.
+
+## Escalation and Enforcement
+
+Smart Invoice will only escalate claims to Kleros that are linked to smart escrows holding tokens with **a minimum value of USD 1,000 at the time of locking the funds**. Smart Invoice is a **Kleros recognised jurisdictions**, when choosing the Kleros arbitration you acknowledge and agree to Smart Invoice executing the arbitration result on behalf of Kleros. Furthermore, you agree your case to be arbitrated by a Kleros court of Kleros' sole discretion and with a fixed number of three jurors assigned exclusively by Kleros. Finally, you acknowledge that from the time of locking the funds until their release, the funds are safeguarded by a multi-sig under the control of Smart Invoice. The arbitration process is provided as is and without warranty.
+
+### Escalation conditions
+
+If you adhere to the following conditions, SmartInvoice escalates the dispute to Kleros courts for resolution. Please keep in mind that the Kleros courts, however, reject your claim in cases where the requested remedy exceeds the value of the claim. You are thus encouraged to properly quantify damages to avoid unnecessary resubmissions of your claim.
+
+1. You have selected Kleros Arbitration when creating the escrow contract on Smart Invoice.
+2. The Smart Invoice holds tokens with a minimum value of USD 1,000 at the time of filing the dispute.
+3. Your Smart Invoice has a project description, a title, and a project specification linked.
+4. You have filled out the [Claimant form](https://forms.gle/K3oMAzAb32G5SbpM9), as well as the lock comment.
+5. You have provided sufficient information in these forms to allow for arbitration.
+6. You have created the smart invoice through [smartinvoice.xyz](https://smartinvoice.xyz).
+7. The goods and services provided do not conflict neither with the laws in the United States of America nor the European Union.
+8. You agree to pay a five (5) percent fee for the arbitration service.
+9. You acknowledge that Smart Invoice or Kleros may anytime, at their sole discretion and without having to provide information decide to halt, abort, or decline arbitration.
+10. You provided a means for SmartInvoice, Kleros, and its agents to contact you in form of an email and you consent to the processing of the related data by these entities.
+
+### Conditions for Resubmission of Claims
+
+Claimants may resubmit their claim in cases, when the court rejected the claim because it is out of proportion to the incurred damages (if damages occurred at all). A resubmission is only possible in cases, where the Kleros court rules that the claim in principle is warranted, however, the requested damages are disproportionate to the claim.
+
+Only in such case of over-quantification, a resubmission with altered damage claims is permissible. The resubmission must be made **within five business days** of the ruling and can only be done **once**. To resubmit, please use the [Google Form for claim submissions](https://forms.gle/K3oMAzAb32G5SbpM9) and select *resubmission*.
+
+All fees associated with a resubmission are to be paid in full by the resubmitting party in advance to the respective multi-sig referenced below **on the correct network**. Failure to do so will result in the resubmission to be disregarded by SmartInvoice and Kleros. Properly transmitting the required funds are your sole responsibility. Neither SmartInvoice nor Kleros can be held liable for your failure to resubmit and pay in an appropriate and timely fashion.
+
+### Appeal
+
+Following the Kleros process, you may appeal to a decision made by a Kleros court for invoices with holding tokens with a **minimum value of USD 2,000 at the time of the dispute**. An appeal will result in the reconsideration of your case as is by a new court that will consist of 2n+1 jurors. Given the limitations agreed upon between SmartInvoice and Kleros for the *Recognition of Jurisdiction* integration, you can only appeal twice. To disambiguate appeals and resubmission, please read the preceding section for clarification.
+
+Appeals must be filed **within five business days** of the ruling and costs are to be paid in full by the appealing party **in advance**, as they are not covered by the fee retained from the invoice. Payments are to be made to the respective multi-sig referenced below **on the correct network**. Failure to do so will result in the appeal to be disregarded by SmartInvoice and Kleros. Properly transmitting the required funds are your sole responsibility. Neither SmartInvoice nor Kleros can be held liable for your failure to appeal and pay in an appropriate and timely fashion.
+
+### Enforcement conditions
+
+1. The dispute has been created only after the escalation conditions were fulfilled and the information provided allows for arbitration to take place.
+2. There is no evidence of negligence, malicious intent, or otherwise ill guided behaviour.
+3. The Kleros court is available to handle the arbitration.
+
+## General Dispute Policy for [smartinvoice.xyz](https://smartinvoice.xyz)
+
+| Version | Date | Document |
+| ------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 1.0 | 2024-04-22 | [Kleros General Dispute Policy for SmartInvoice](https://docs.google.com/document/d/1z_l2Wc8YHSspB0Lm5cmMDhu9h0W5G4thvDLqWRtuxbA/edit?usp=sharing) |
+
+This policy is crafted for Kleros Jurors to ensure transparency, fairness, and efficiency in resolving disputes, safeguarding the interests of both Clients and Providers engaged in transactions on SmartInvoice.xyz. Thus, it falls outside of the responsibility and liability of SmartInvoice. If you choose Kleros as an arbitration provider, you are entering into a contractual relationship with the Kleros entities on the basis of this policy.
+
+It functions as the basis of decision making for jurors in cases related to Smart Invoice. This policy honours the principle of contractual freedom, while providing clearer subsidiary rules for cases in which the agreement between the disputed parties is not sufficient to determine if there was a breach of contract and how to appropriately value damages.
+
+## Court Parameters
+
+Through the *Recognition of Jurisdiction* integration with Kleros, users of SmartInvoice may use choose from the list of three courts below when creating an escrow on [smartinvoive.xyz](https://smartinvoice.xyz). All courts offered by Kleros to SmartInvoice users are on the **Gnosis (xDAI) chain**. After an escrow was created courts **cannot be changed**.
+
+### Available Courts
+
+1. **[xDAI General Court](https://klerosboard.com/100/courts/0)**
+ - Chain: Gnosis (xDai)
+ - Jurors drawn in the first round: 3
+ - Juror Vote Reward: 13 xDAI per juror
+ - [Smart Contract](https://gnosis.blockscout.com/address/0xc7add3c961f7935cb4914e37da991d2f1cd7986c)
+1. **[xDai Solidity Court](https://klerosboard.com/100/courts/13)**
+ - Chain: Gnosis (xDai)
+ - Jurors drawn in the first round: 2
+ - Juror Vote Reward: 30 xDAI per juror
+ - [Smart Contract](https://gnosis.blockscout.com/address/0xce9260c08272fa39c9af1307cd079dc5636bee01)
+1. **[xDai Javascript Court](https://klerosboard.com/100/courts/14)**
+ - Chain: Gnosis (xDai)
+ - Jurors drawn in the first round: 2
+ - Juror Vote Reward: 30 xDAI per juror
+ - [Smart Contract](https://gnosis.blockscout.com/address/0x9fe4d9e4989ad031fdc424d8c34d77e70aa0b269)
+
+## Integration with the Court
+
+- Type: *Recognition of Jurisdiction* (*RoJ*)
+- Github link: *[smart-invoice](https://github.com/SmartInvoiceXYZ/smart-invoice)*
+
+## Fees
+
+SmartInvoice takes a flat fee of five percent (5%) of the disputed funds for covering arbitration. For this reason, Kleros is not offered for disputed escrows that hold less than USD 1,000 in funds. Arbitration fees arising out of the use of Kleros that are above the 5% fee are to be paid in advance to the appropriate arbitration multi-sig of SmartInvoice for the respective network. Additional fees apply to the following services:
+
+- choosing a specialised court,
+- adding jurors,
+- resubmitting a claim, and,
+- appealing a claim
+
+## Considerations
+
+SmartInvoice wants to offer its users escrow services not only on Gnosis, but also on Optimism, Base, Arbitrum, and Polygon. For Polygon and Gnosis chain, you should consider which arbitration provider best fits your needs, as Smart Invoice has the broadest arbitration offering on these networks.
+
+New chains that are not currently covered natively by Kleros, will be available on Smart Invoice through *Kleros RoJ*. This means that SmartInvoice will execute the decision made by Kleros jurors through the multi-sigs referenced in the next section.
+
+### Hats Signer Gate Addresses (3/5)
+
+If you are looking for more detailed documentation on our arbitration infrastructure, please visit our [arbitration infrastructure section](docs-v3/arbitration/arbitration_policies/arbitration_infra.md). Below is a list of all Safes currently operational for providing *Kleros RoJ* arbitration.
+
+- Arbitrum Arbitration [Safe](https://app.safe.global/home?safe=arb1:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Base Arbitration [Safe](https://app.safe.global/home?safe=base:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Gnosis Arbitration [Safe](https://app.safe.global/home?safe=gno:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Optimism Arbitration [Safe](https://app.safe.global/home?safe=oeth:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Polygon Arbitration [Safe](https://app.safe.global/home?safe=matic:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+
diff --git a/packages/website/docs-v3/arbitration/lexdao-arbitration.md b/packages/website/docs-v3/arbitration/lexdao-arbitration.md
new file mode 100644
index 00000000..698ad8ca
--- /dev/null
+++ b/packages/website/docs-v3/arbitration/lexdao-arbitration.md
@@ -0,0 +1,36 @@
+---
+title: LexDAO Arbitration Policy
+---
+
+## Introduction
+
+As part of our commitment to providing secure, transparent, and efficient mechanisms for resolving disputes, Smart Invoice provides an advanced arbitration feature in collaboration with the LexDAO Cooperative. This feature brings trust and reliability in pseudonymous digital transactions, making service agreements in Web3 safe. The arbitration process we have implemented serves is a crucial component in ensuring that all parties engaged in a transaction can resolve their conflicts in a fair and unbiased manner.
+
+The choice of arbitration as a dispute resolution mechanism is motivated by the necessity to address disagreements swiftly and effectively, without the need for lengthy and often costly court proceedings. By integrating with the *LexDAO Resolver*, Smart Invoice leverages the expertise of seasoned arbitrators and the robustness of smart contracts to offer a streamlined, secure process for resolving disputes.
+
+## Arbitration Process
+
+Below, the arbitration process is outlined in detail. Beginning with the selection of the arbitration provider at the inception of the smart invoice contract, the takes effect when a dispute is triggered by either of the contracting parties. At this point and until the final resolution with the fund disbursement in accordance with the arbitrators' ruling representatives of the *LexDAO Resolver* manage the arbitration process for the contracting parties.
+
+1. LexDAO is selected as arbitration provider at the creation of the smart invoice contract.
+2. A conflict arises between two Smart Invoice users, who have chosen *LexDAO Resolver* as arbitration provider. One of the parties locks the funds in the Smart Invoice escrow by calling the `lock()` function.
+3. The user locking the funds is prompted to complete a form detailing the reason for the claim, a justification, and evidence.
+4. The document is stored on IPFS.
+5. After `lock()` was called, the funds are forwarded to a three out of five signers multi-signature wallet controlled by representatives of the *LexDAO Resolver*.
+6. Representatives of the *LexDAO Resolver* are notified by the claimant via email to [lexdaocoop@gmail.com](mailto:lexdaocoop@gmail.com).
+7. The arbitrators of the *LexDAO Resolver* review the evidence and rule according to the [UNCITRAL arbitration rules](https://uncitral.un.org/en/texts/arbitration/contractualtexts/arbitration).
+8. *LexDAO Resolver* releases the disputed funds pro rata minus the fee in line with their ruling.
+
+## Fees
+
+Arbitration by LexDAO is subject to a five (5) percent fee of the disputed amount payable pro rata by the parties according to the ruling of the arbitrator.
+
+## Specifications
+
+The LexDAO Arbitration is specified in this [document](https://github.com/lexDAO/Arbitration).
+
+## Terms of Use
+
+The terms of use for the LexDAO Resolver are set out [here](https://github.com/lexDAO/Arbitration/blob/master/rules/ToU.md).
+
+**Any controversy, dispute or claim among the parties arising out of or relating to this agreement, or the breach, termination or validity thereof, shall be finally settled by LexDAO Arbitration in accordance with the rules and procedures recorded on [https://github.com/lexDAO/Arbitration](https://github.com/lexDAO/Arbitration).**
\ No newline at end of file
diff --git a/packages/website/docs-v3/arbitration/smart-invoice-arbitration.md b/packages/website/docs-v3/arbitration/smart-invoice-arbitration.md
new file mode 100644
index 00000000..661533b4
--- /dev/null
+++ b/packages/website/docs-v3/arbitration/smart-invoice-arbitration.md
@@ -0,0 +1,94 @@
+---
+title: Smart Invoice Arbitration Policy
+---
+
+## Introduction
+
+Smart Invoice is committed to providing resilient and flexible arbitration solutions that satisfy institutional needs, as well as cost-effective alternatives for users working as freelancers or use Smart Invoice for small sums only. Since [Kleros](https://kleros.io) requires invoices to hold a minimum value of USD 1,000 at the time of the dispute and arbitration by LexDAO is only available on Gnosis Chain and Polygon, *Smart Invoice* also offers in-house arbitration for invoices not exceeding a value of USD 1,000 **at any time**. Should your invoice exceed the threshold value, the arbitration is escalated to Kleros automatically. Please refer to [Arbitration by Kleros](docs-v3/arbitration/arbitration_policies/kleros-arbitration.md) for reference. Smart Invoice executes in-house and *Kleros* arbitrations through a [HATs Signer Gate-protected](https://hats-signer-gate-portal.vercel.app/deploy/hsgws) multi-sig wallet.
+
+## *Smart Invoice* Arbitration Process
+
+1. A conflict arises between two Smart Invoice users, who have chosen arbitration to take place in-house by Smart Invoice. One of the parties locks the funds in the Smart Invoice escrow by calling the `lock()` function.
+2. The user locking the funds is prompted to complete a form detailing the reason for the claim, a justification, and evidence.
+3. After `lock()` was called, the funds are forwarded to a three out of five signers multi-signature wallet controlled by Smart Invoice representatives.
+4. Smart Invoices' arbitration committee convenes and reviews the evidence submitted by the claimant through the lock form.
+5. Smart Invoice finds a resolution for the case and the Smart Invoice representatives execute the multi-sig accordingly.
+
+### Submission of Evidence
+
+The evidence you are submitting to the Kleros Court consists of the following:
+- Smart Invoice data, including the project description, linked project specification
+- a claim statement collected from you when locking the funds
+
+Please note that all evidence must be provided through the **lock form** provided on [smartinvoice.xyz](https://smartinvoice.xyz)to be admitted to the arbitration process. **Failing to provide relevant information in the project description and through the forms will lead to its exclusion in the arbitration process.** It is your sole responsibility to provide all necessary information. Providing additional information when locking the funds.
+
+For a project description that is linked to an escrow account on SmartInvoice upon creation, to be valid and considered as evidence by Kleros, the project description must be available as tamperproof and non-repudiable document. That may be a linked document that was signed using DocuSign, an IPFS hash, or similar. Otherwise, you will have to submit evidence in the lock form that irrefutably proofs that the version of the document linked in the escrow description matches the version and document that was agreed upon by both parties.
+
+## Escalation and Enforcement
+
+Smart Invoice will only arbitrate or escalate claims that are linked to smart escrows holding tokens with **a maximum value of USD 1,000 anytime**. When choosing the Smart Invoice arbitration you acknowledge and agree to Smart Invoice executing the arbitration result and certify that your counterparty agrees to the arbitration by Smart Invoice. Furthermore, you agree your case to be arbitrated by Smart Invoices' sole discretion and with a fixed number of three arbitrators assigned ONLY by Smart Invoice and its entities. Finally, you acknowledge that from the time of locking the funds until their release, the funds are safeguarded by a multi-sig under the control of Smart Invoice. The arbitration process is provided as is and without warranty.
+
+### Escalation conditions
+
+If you adhere to the following conditions, SmartInvoice arbitrates your dispute. Please keep in mind that Smart Invoice MAY reject your claim in cases where the requested remedy exceeds the value of the claim. You are thus encouraged to properly quantify damages to avoid unnecessary resubmissions of your claim.
+
+1. You have selected Smart Invoice Arbitration when creating the escrow contract on Smart Invoice.
+2. The Smart Invoice never held tokens with worth an excess of USD 1,000.
+3. Your Smart Invoice has a project description, a title, and a project specification linked.
+4. You have filled out the lock form.
+5. You have provided sufficient information in these forms to allow for arbitration.
+6. You have created the smart invoice through [smartinvoice.xyz](https://smartinvoice.xyz).
+7. The goods and services provided do not conflict neither with the laws in the United States of America nor the European Union.
+8. You agree to pay a five (5) percent fee for the arbitration service.
+9. You acknowledge that Smart Invoice may anytime, at their sole discretion and without having to provide information decide to halt, abort, or decline arbitration.
+10. You provided a means for SmartInvoice and its agents to contact you in form of an email and you consent to the processing of the related data by these entities.
+
+### Conditions for Resubmission of Claims
+
+Claimants MAY NOT resubmit their claim in cases, when the court rejected the claim because it is out of proportion to the incurred damages (if damages occurred at all).
+
+### Appeal
+
+Claimants MAY NOT appeal to a decision made by Smart Invoice.
+
+### Enforcement conditions
+
+1. The dispute has been created only after the escalation conditions were fulfilled and the information provided allows for arbitration to take place.
+2. There is no evidence of negligence, malicious intent, or otherwise ill guided behaviour.
+3. Smart Invoice is available to handle the arbitration.
+
+## Fees
+
+SmartInvoice takes a flat fee of five percent (5%) of the disputed funds for covering arbitration.
+
+## Considerations
+
+SmartInvoice wants to offer its users escrow services not only on Gnosis, but also on Optimism, Base, Arbitrum, and Polygon. For Polygon and Gnosis chain, you should consider which arbitration provider best fits your needs, as Smart Invoice has the broadest arbitration offering on these networks.
+
+### Hats Signer Gate Addresses (3/5)
+
+If you are looking for more detailed documentation on our arbitration infrastructure, please visit our [arbitration infrastructure section](docs-v3/arbitration/arbitration_policies/arbitration_infra.md). Below is a list of all Safes currently operational for providing *in-house* arbitration.
+
+- Arbitrum Arbitration [Safe](https://app.safe.global/home?safe=arb1:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Base Arbitration [Safe](https://app.safe.global/home?safe=base:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Gnosis Arbitration [Safe](https://app.safe.global/home?safe=gno:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Optimism Arbitration [Safe](https://app.safe.global/home?safe=oeth:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+- Polygon Arbitration [Safe](https://app.safe.global/home?safe=matic:0x18542245cA523DFF96AF766047fE9423E0BED3C0)
+
+## Terms
+
+### Disclaimer Regarding the Selection of Custom Arbitration Arbitrators
+
+In the event of a user (hereinafter “the User”) choosing a Smart Invoice in-house arbitration for [smartinvoice.xyz](https://smartinvoice.xyz) (hereinafter referred to as "In-House Arbitrator"), the User assumes full and exclusive responsibility for the selection, engagement, and outcomes associated with the use of the In-House Arbitrator. The User, hereby, agrees and acknowledges that SmartInvoice.xyz, its affiliates, representatives, agents, advisors (collectively, "SmartInvoice.xyz") SHALL bear no liability, whether direct, indirect, incidental, special, punitive, consequential, or otherwise, for any and all claims, damages, losses, expenses, costs, obligations, or liabilities, including but not limited to legal fees, arising out of, related to, or in connection with the User's decision to utilise the In-House Arbitrator for arbitration purposes.
+
+The User acknowledges and agrees that SmartInvoice.xyz provides no warranties, express or implied, as to the suitability, legality, reliability, quality, integrity, or availability of the In-House Arbitrator selected by the User. Furthermore, the User explicitly absolves SmartInvoice.xyz from any responsibility for the acts, omissions, decisions, or outcomes produced by the In-House Arbitrator, including but not limited to the resolution of disputes, the handling of any funds in escrow, and the enforcement of any arbitration awards.
+
+By choosing a In-House Arbitrator, the User confirms their understanding of and agreement to the fact that SmartInvoice.xyz's provision of its platform and related services SHALL be governed entirely by the terms and conditions, rules, and procedures established in the context of engaging the In-House Arbitrator.
+
+### Indemnification Clause
+
+The User hereby agrees to indemnify, defend, and hold harmless SmartInvoice.xyz from and against any and all claims, damages, liabilities, costs, and expenses, including reasonable attorneys’ fees and costs, arising out of or in any way connected with the User’s selection, engagement, and use of its In-House Arbitrator, or the User’s breach of any representation, warranty, or covenant under this disclaimer or the terms and conditions of SmartInvoice.xyz and its In-House Arbitrator. This indemnification obligation will survive the termination or expiration of the User’s use of SmartInvoice.xyz and/or the selection of a In-House Arbitrator.
+
+### Severability Clause
+
+If any provision of this disclaimer, or the application thereof to any person or circumstance, is found to be invalid, void, or unenforceable to any extent, such invalidity, voidness, or unenforceability shall not affect the remaining provisions hereof, and the application of such provision to other persons or circumstances, which shall enforce to the fullest extent permitted by law. The parties hereby agree to replace any invalid, void, or unenforceable provision with a valid and enforceable provision that most closely matches the intent of the original provision. The remaining provisions of this disclaimer shall continue in full force and effect.
\ No newline at end of file
diff --git a/packages/website/docs-v3/docs-intro.md b/packages/website/docs-v3/docs-intro.md
new file mode 100644
index 00000000..6f834fd8
--- /dev/null
+++ b/packages/website/docs-v3/docs-intro.md
@@ -0,0 +1,27 @@
+---
+title: Smart Invoice Documentation
+---
+
+Welcome to the documentation of *Smart Invoice*. Here, you find information on how to best get started, tutorials, answers to frequently asked questions, and everything you need to know about **arbitration** - including our arbitration policies.
+
+If you want to learn more about integrating *Smart Invoice* into your platform, consider taking a look on [GitHub](https://github.com/SmartInvoiceXYZ). In the future, we may offer additional information on integrating with *Smart Invoice*. Meanwhile, give us a shout and we are happy to help you out.
+
+## Structure
+
+The documentation of *Smart Invoice* is structured as follows.
+
+### [Getting Started](docs-v3/getting-started/1_getting-started-intro.md)
+
+This section provides you with a quick guide for your first invoice from creation to release.
+
+### [Tutorials](docs-v3/tutorials/1_tutorials-intro.md)
+
+Eager to take a deep dive, but unsure where to start? Our tutorials walk you through step-by-step and ensure that you can navigate *Smart Invoice* with ease.
+
+### [Miscallaneous](docs-v3/misc/1_misc-intro.md)
+
+*Smart Invoice* grew quite a bit over the last years. Here you find hidden gems, edge cases and anything you always wanted to have an answer to.
+
+### [Arbitration](docs-v3/arbitration/1_arbitration-intro.md)
+
+The arbitration section is split in three parts. First, you learn all the necessary background on [our arbitration offering](docs-v3/arbitration/getting-started-with-arbitration/1_intro_arbitration_primer.md). Second, you can read up on our [Arbitration Policies](docs-v3/arbitration/arbitration_policies/1_arbitration_policies_overview.md). Finally, we want to ensure that you can verify our [arbitration infrastructure](docs-v3/arbitration/arbitration_policies/arbitration_infra.md).
\ No newline at end of file
diff --git a/packages/website/docs-v3/getting-started/how-do-i-log-in.md b/packages/website/docs-v3/getting-started/how-do-i-log-in.md
new file mode 100644
index 00000000..7526d0d1
--- /dev/null
+++ b/packages/website/docs-v3/getting-started/how-do-i-log-in.md
@@ -0,0 +1,13 @@
+---
+title: How do I log in?
+---
+
+Smart Invoice is a web3 application, which means you don’t actually create an account with an email address like you would with credit card invoicing tools.
+
+So there is no traditional “log in” process.
+
+To use Smart Invoice, you simply connect your cryptocurrency wallet to the site and you are logged in. Super easy and safe.
+
+If the prompt doesn't automatically appear, click the "Create Invoice" button to trigger it.
+
+
diff --git a/packages/website/docs-v3/getting-started/what-is-escrow.md b/packages/website/docs-v3/getting-started/what-is-escrow.md
new file mode 100644
index 00000000..899a06bb
--- /dev/null
+++ b/packages/website/docs-v3/getting-started/what-is-escrow.md
@@ -0,0 +1,13 @@
+---
+title: What is escrow?
+---
+
+Escrow is a legal arrangement in which a third party temporarily holds assets until the terms of an agreement have been met.
+
+This provides a level of safety and security for both parties without the risk of one side running away.
+
+In the case of Smart Invoice, this “third party” is a smart contract.
+
+The contractor promises to fulfill a specific service and only gets paid once the service is delivered according to the terms of the agreement.
+
+The client funds the escrow so the contractor can begin work, and once that work is completed, the client can release those funds from the escrow into the contractor's wallet.
diff --git a/packages/website/docs-v3/getting-started/what-is-locking-and-arbitration.md b/packages/website/docs-v3/getting-started/what-is-locking-and-arbitration.md
new file mode 100644
index 00000000..c0668e3b
--- /dev/null
+++ b/packages/website/docs-v3/getting-started/what-is-locking-and-arbitration.md
@@ -0,0 +1,23 @@
+---
+title: What is "locking" and arbitration?
+---
+
+### What is "locking"?
+
+If there is a dispute, you or your client can click a button to “lock” funds held by that invoice. This lock triggers the arbitration provider (Kleros, or the custom arbitrator you chose) to review and resolve the dispute.
+
+If the client loses confidence in the contractor at any time, or the contractor under delivers on their promise, the client may lock any remaining funds in Smart Invoice so they cannot be released or withdrawn.
+
+Alternatively, if the client has not released funds after a milestone is complete, the contractor may lock any remaining funds in Smart Invoice.
+
+
+
+### What is arbitration?
+
+Arbitration is triggered by either the client or contractor locking funds held by their smart invoice.
+
+Arbitration is the process of resolving a dispute between a client and a contractor, and it is facilitated by a third-party adjudicator.
+
+Based on the arbitrator’s review, they will determine who should receive funds and will send a transaction to Smart Invoice that transfers those funds to the contractor or the client.
+
+Our recommended arbitrator, Kleros, currently charges a 5% fee that is automatically deducted from the funded milestone for their arbitration services.
\ No newline at end of file
diff --git a/packages/website/docs-v3/getting-started/what-is-smart-invoice.md b/packages/website/docs-v3/getting-started/what-is-smart-invoice.md
new file mode 100644
index 00000000..c3734427
--- /dev/null
+++ b/packages/website/docs-v3/getting-started/what-is-smart-invoice.md
@@ -0,0 +1,7 @@
+---
+title: What is Smart Invoice?
+---
+
+Smart Invoice is a free crypto invoicing tool that allows freelancers to easily, and securely, accept cryptocurrency payments for their work.
+
+With integrated escrow and arbitration services, freelancers are able to protect themselves from chargebacks and fraud as they do business with anyone, even if they don’t know or trust them yet.
diff --git a/packages/website/docs-v3/getting-started/who-should-use-smart-invoice.md b/packages/website/docs-v3/getting-started/who-should-use-smart-invoice.md
new file mode 100644
index 00000000..c334600e
--- /dev/null
+++ b/packages/website/docs-v3/getting-started/who-should-use-smart-invoice.md
@@ -0,0 +1,8 @@
+---
+title: Who should use Smart Invoice?
+---
+
+Freelancers, contractors, service providers, and any other organization that needs to safely accept cryptocurrencies in exchange for their work.
+
+Individuals and organizations that are “clients” and need to pay invoices with cryptocurrencies.
+
diff --git a/packages/website/docs-v3/misc/FAQ.md b/packages/website/docs-v3/misc/FAQ.md
new file mode 100644
index 00000000..42e7584e
--- /dev/null
+++ b/packages/website/docs-v3/misc/FAQ.md
@@ -0,0 +1,221 @@
+---
+title: FAQ
+---
+
+### Does Smart Invoice have access to my funds?
+
+No. Each invoice created with Smart Invoice configures a custom smart contract that is only linked to the wallet addresses of the contractor, client, and arbitrator.
+
+No one else besides these 3 parties can interact with the invoice in any way.
+
+This means the Smart Invoice team cannot edit, modify, fix, or delete the invoices you create. If funds are sent to the wrong address, we cannot help you.
+
+
+### Is KYC required?
+
+No. You do not need to share your personal identity to use Smart Invoice.
+
+
+### Is there a minimum / maximum invoice amount?
+
+There are no maximum or minimum amount or milestone restrictions when creating an invoice.
+
+For very large projects, you can add as many milestones and payments as you like either during or after invoice creation.
+
+While differing network fees will change the considerations for a rational minimum invoice amount, invoices can be created with very small amounts and will work exactly the same.
+
+### I don’t see a specific token listed, why?
+
+If you don’t see a supported token listed in the drop down menu, you may be connected to the wrong Network.
+
+Check your wallet to ensure you are connected to the proper network for your preferred token, and then refresh your browser.
+
+This will reset your invoice to the beginning and you will need to start over, but you should see your preferred token in the drop down menu now.
+
+
+### Does Smart Invoice allow payment methods besides cryptocurrency?
+
+No. Smart Invoice is cryptocurrency specific.
+
+
+### How much does Smart Invoice cost?
+
+Smart Invoice is a free tool. We do not charge any fee to use it.
+
+However, you will need to pay gas fees to transact on the blockchain. Your preferred wallet will display the fees to process a transaction.
+
+If you dispute a payment and it goes to arbitration, there will be a fee that goes to the arbitrator to resolve the dispute. This is currently set at 5% of the disputed funds for Kleros - however, you can modify this amount if you choose a custom arbitrator.
+
+
+### Can I put my logo on these invoices?
+
+At the moment it is not possible to customize invoices with custom branding.
+
+### Can I use non-Ethereum wallet addresses?
+
+No. Smart Invoice only supports ERC-20 tokens. If your wallet address doesn’t support those, don’t use it with Smart Invoice.
+
+### What blockchains does Smart Invoice support?
+
+Smart Invoice supports Ethereum Mainnet, Gnosis, Polygon, Arbitrum, Optimism, Base, Holesky, and Sepolia Testnet.
+
+
+### Does Smart Invoice work with Bitcoin (BTC)?
+
+No. Smart Invoice is NOT configured to accept BTC payments. If a client sends a BTC payment to the wallet address listed on an invoice, those funds will be lost forever.
+
+
+### Can I sync my invoices with any accounting tools?
+
+No. Smart Invoice is a standalone tool and does not currently integrate with any accounting software.
+
+However, you are able to download PDFs of each invoice.
+
+
+### MetaMask security and best practices
+
+**Password, seed phrases, private keys**
+
+Never, ever, ever, ever reveal your private key or seed phrase to anyone! Do not store it on your computer, device or in an email. Print it out and store it in a secure location. Your private key is functionally your identity to a blockchain. If you lose control of your private key or seed phrase your funds will be irrevocably lost.
+
+No support service will ever ask you for either of these. If they do, it’s a scam.
+
+Do not use a browser extension wallet on a shared computer and use a unique password to access your wallet.
+
+**Hot and Cold Wallets**
+‘Hot’ wallets, such as Metamask, are connected to the internet. While the most convenient they are also the most vulnerable to security breaches.
+
+‘Cold’ wallets, such as Ledger, are not connected to the internet, unless you connect them physically while you are performing a transaction. While much more secure, they are more inconvenient to use.
+
+If you have any significant amount of crypto, consider having at least two wallets. One hot wallet with a small amount of crypto to interact with dApps and the ecosystem, and a second hot or cold (preferably cold if your funds are very significant) wallet that holds the majority of your funds.
+
+**Contract Interaction**
+
+Interacting with smart contracts is an elemental part of the blockchain ecosystem.
+
+However, new, and even veteran users, are not often aware of what they are explicitly allowing the contract to do with their funds and wallets.
+
+The below screenshot is from connecting to a web3 site. Read what permissions you are giving to the site with your connection.
+
+
+
+Likewise when signing a transaction, the wallet will tell you exactly what function you are interacting with on the contract.
+
+
+
+However, even at this level, there are attack vectors for unsuspecting users. Your wallet that interacts the most with the ecosystem should hold only enough crypto for transaction fees.
+
+ Contract interaction: Token Allowances
+
+If you interact with an exchange or bridge, you will often need to sign a token approval/allowance transaction to allow the smart contract access to your funds. While this is a necessary step for the contract to work with your funds, the typical token approval limit is the maximum amount of tokens in your wallet. Which essentially means the contract could spend every token in your wallet if you grant that allowance to a malicious actor.
+
+If you only interact with vetted exchanges and bridges, you eliminate almost all of the risk from this attack vector.
+
+To see all the contract allowances your wallet has granted visit https://revoke.cash/ and connect your wallet. Once connected, you will see all token allowances and can rescind them from the same page.
+
+Revoke.cash is Gitcoin funded, open-source, and professionally audited.
+
+Tip: Rescind all token permissions on your wallet with some regularity i.e. once a month.
+
+
+
+### How to add an ERC-20 token to your wallet
+
+Given that Metamask is by far the most popular wallet in use, we will be using Metamask for all our examples. The concepts below hold true for all wallets, although the UI will change slightly from wallet to wallet.
+
+**Adding Common Tokens on Ethereum Mainnet**
+Metamask makes it very simple to add common ERC-20 tokens on mainnet.
+
+Make sure you are connected to Ethereum Mainnet.
+
+
+
+Click on the assets tab. Scroll down and select ‘Import Tokens’.
+
+
+
+Type in the token symbol for the token you want to add. Click on the desired token, then click Next.
+
+
+
+Click ‘Import Tokens’.
+
+
+
+Your selected token will now appear under the Assets tab.
+
+
+
+Importing tokens on other networks (xDai, Rinkeby, etc…)
+
+For every other network you will need to add new tokens manually.
+
+In this example we will be adding WXDAI to our wallet on the Gnosis chain.
+
+1) Navigate to the block explorer for Gnosis: https://blockscout.com/xdai/mainnet
+
+
+
+2) Type in WXDAI in the search bar. Click on the result below: Wrapped XDAI.
+
+
+
+3) Copy the token contract address: 0xe91d153e0b41518a2ce8dd3d7944fa863463a97d
+
+
+
+5) Open Metamask. Confirm you are on the Gnosis chain.
+
+
+
+6) Click on the Assets tab and scroll down to Import Tokens.
+
+
+
+7) Enter the required information.
+
+Paste the token contract address you copied from the block explorer into ‘Token Contract Address’.
+
+
+The token symbol (WXDAI) should automatically appear. Type it in if it does not.
+
+Enter 18 for ‘Token Decimal’. All tokens added with Smart Invoice will use 18 decimals.
+
+Click ‘Add Custom Token’ after all information is added.
+
+
+
+8) Click ‘Import Tokens’.
+
+
+
+9) You now have access to your WXDAI in Metamask.
+
+
+
+
+### What is the safety valve date?
+
+The Safety Valve is a built-in function that allows the client to withdraw funds from the funded escrow.
+
+In the event the contractor is unresponsive or bails on the project, the Safety Valve prevents the client from losing the funds already deposited into the escrow or relying on an arbitrator to release them.
+
+Once the selected Safety Valve Date is passed, the client can withdraw the funds out of the escrow and back into their own wallet.
+
+
+### What’s the difference between my wallet address and the invoice escrow address?
+
+Your wallet address is the address in which you will transact with Smart Invoice. It’s how invoices are created, escrow is funded, milestones payments are released, and disputes are initiated.
+
+For the client, they use their wallet address to send funds to the invoice escrow address.
+
+For the contractor, milestone payments are released from the invoice escrow address to their wallet address.
+
+
+### How private are my invoice transactions?
+
+Transactions on the blockchain are public for anyone to see.
+
+Your transactions with Smart Invoice are no different. Your wallet address, balance, client’s wallet address, payment history, and payment amount are all visible to anyone that looks.
+
+Additionally, all invoice data is stored publicly on IPFS and can be viewed by anyone. If you have privacy concerns, we recommend encrypting or adding permissions to your project agreement document before linking to it in the invoice.
diff --git a/packages/website/docs-v3/misc/get-support.md b/packages/website/docs-v3/misc/get-support.md
new file mode 100644
index 00000000..b73e07ec
--- /dev/null
+++ b/packages/website/docs-v3/misc/get-support.md
@@ -0,0 +1,9 @@
+---
+title: Get Support
+---
+
+Still can’t figure Smart Invoice out? No worries, our team is happy to help you directly.
+
+We’re available in the Smart Invoice Discord
+
+Once in there, leave a message for us in the “support” channel.
diff --git a/packages/website/docs-v3/misc/troubleshooting.md b/packages/website/docs-v3/misc/troubleshooting.md
new file mode 100644
index 00000000..c1e446cd
--- /dev/null
+++ b/packages/website/docs-v3/misc/troubleshooting.md
@@ -0,0 +1,25 @@
+---
+title: Troubleshooting
+---
+
+### Why are incorrect dates / times showing up on the PDF invoice?
+
+If you see an incorrect date, it’s possible it is in a format you are not used to. Smart Invoice is based in the USA and uses the standard American Month/Day/Year format.
+
+All times use GMT and will not reflect your local timezone.
+
+
+### Why don’t I see the token I need in the invoice creation list?
+
+If you don’t see a supported token listed in the drop down menu, you may be connected to the wrong Network.
+
+Check your wallet to ensure you are connected to the proper network for your preferred token, and then refresh your browser.
+
+This will reset your invoice to the beginning and you will need to start over, but you should see your preferred token in the drop down menu now.
+
+
+### Why don’t I see any of my invoices?
+
+If you don’t see any of your invoices after you’ve connected your correct wallet to Smart Invoice, your invoices may be stored on the legacy version of Smart Invoice.
+
+Smart Invoice was rebooted September 7, 2022 and if you used the tool before this date, you will need to visit legacy.smartinvoice.xyz and reconnect your wallet to your old invoices.
diff --git a/packages/website/docs-v3/tutorials/arbitrator/notify-arbitration-decision.md b/packages/website/docs-v3/tutorials/arbitrator/notify-arbitration-decision.md
new file mode 100644
index 00000000..abde53be
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/arbitrator/notify-arbitration-decision.md
@@ -0,0 +1,15 @@
+---
+title: How to notify the contractor and client of arbitration decision
+---
+
+Both client and provider will see the results of your decision on the invoice page.
+
+After the resolution transaction is confirmed, the invoice page will list the total amount disbursed, your arbitration fee, and the awarded amounts to client and provider.
+
+**View details on IPFS:** Your written decision is stored on IPFS and viewable by all parties from this link.
+
+**View transaction:** From this link, all parties can view the resolution transaction on the network’s block explorer.
+
+
+
+Currently there is no notification of the decision to the client and provider outside of the platform, although this is a projected future feature. You will need to message them directly.
diff --git a/packages/website/docs-v3/tutorials/arbitrator/release-disputed-escrow-funds.md b/packages/website/docs-v3/tutorials/arbitrator/release-disputed-escrow-funds.md
new file mode 100644
index 00000000..84ff04ea
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/arbitrator/release-disputed-escrow-funds.md
@@ -0,0 +1,15 @@
+---
+title: How to release disputed escrow funds to the contractor or client
+---
+
+From the individual invoice page, click ‘Resolve’. The dispute resolution modal will appear.
+
+
+
+From this modal you will detail your arbitration decision and divide the disputed amount according to your decision.
+
+You are paid 5% of the disputed amount for your arbitration services. Therefore the client and provider awards together will add up to 95% of the disputed amount.
+
+Click Resolve when you have completed all fields and sign the prompted transaction from your wallet provider. The funds will be distributed to both parties according to your decision.
+
+Thoroughly double check your decision and award amounts before clicking Resolve. After the transaction is signed there is no way to modify the decision.
diff --git a/packages/website/docs-v3/tutorials/arbitrator/view-invoice-milestones.md b/packages/website/docs-v3/tutorials/arbitrator/view-invoice-milestones.md
new file mode 100644
index 00000000..99c5bbea
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/arbitrator/view-invoice-milestones.md
@@ -0,0 +1,15 @@
+---
+title: How to view invoice milestones in dispute
+---
+
+Navigate to the invoice dashboard. Disputed invoices that require arbitration will have a red ‘In Dispute’ status label.
+
+
+
+Click the ‘In Dispute’ label and you will reach the disputed invoice.
+
+From the invoice page you can view pertinent details about the dispute including the disputed amount, the project agreement (‘View details on IPFS’) and the original invoice transaction.
+
+Click ‘Resolve’ to begin the arbitration process.
+
+
diff --git a/packages/website/docs-v3/tutorials/client/deposit-funds.md b/packages/website/docs-v3/tutorials/client/deposit-funds.md
new file mode 100644
index 00000000..935a5738
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/client/deposit-funds.md
@@ -0,0 +1,31 @@
+---
+title: How to deposit funds into the invoice’s escrow
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+Click on an invoice in the list to open it.
+
+
+
+Here you can view all the details relevant to your invoice, and the specific actions you can perform.
+
+Click the “Deposit” button.
+
+
+
+A prompt will appear where you can select the payment milestones you want to fund.
+
+Tick the boxes next to the payment milestones you want to deposit funds to.
+
+Then enter the amount you want to fund in the field, and ensure the correct cryptocurrency is selected.
+
+Then click the blue “Deposit” button.
+
+
+
+Your wallet will display a prompt. Review the details and click “Confirm” to complete the transaction and fund the escrow.
diff --git a/packages/website/docs-v3/tutorials/client/download-invoice-as-pdf.md b/packages/website/docs-v3/tutorials/client/download-invoice-as-pdf.md
new file mode 100644
index 00000000..9aaedffb
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/client/download-invoice-as-pdf.md
@@ -0,0 +1,15 @@
+---
+title: How to download a PDF of your invoice as a client
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+Click on an invoice in the list to open it.
+
+
+
+Click "Preview and download invoice PDF" at the bottom left of your invoice.
diff --git a/packages/website/docs-v3/tutorials/client/lock-milestone-and-request-arbitration.md b/packages/website/docs-v3/tutorials/client/lock-milestone-and-request-arbitration.md
new file mode 100644
index 00000000..49df3b3b
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/client/lock-milestone-and-request-arbitration.md
@@ -0,0 +1,29 @@
+---
+title: How to lock a milestone and request arbitration if there is a dispute
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+Click on an invoice in the list to open it.
+
+
+
+Here you can view all the details relevant to your invoice, and the specific actions you can perform.
+
+If there are any milestones that you have funded via escrow, but have not yet released to your contractor’s wallet address, you can click the “lock” button.
+
+This will display a prompt where you can enter the details of your dispute. These details will be sent to the arbitrator you selected during the invoice creation process.
+
+
+
+Click the “Lock” button to begin the arbitration process.
+
+Now your arbitrator will see the details of your dispute inside of their Smart Invoice account, and can determine who to release funds to.
+
+It is essential that you contact your chosen arbitrator manually (email, text, DM, etc) to notify them about the dispute. Then they can log into Smart Invoice to manage this dispute.
+
+***Note: Smart Invoice does not notify the arbitrator about the dispute. They will see it in their Smart Invoice account, but you need to notify them to log into their account.***
diff --git a/packages/website/docs-v3/tutorials/client/release-escrow-funds-inside-milestone.md b/packages/website/docs-v3/tutorials/client/release-escrow-funds-inside-milestone.md
new file mode 100644
index 00000000..bc46bfc8
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/client/release-escrow-funds-inside-milestone.md
@@ -0,0 +1,23 @@
+---
+title: How to release escrow funds held inside of a milestone
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+Click on an invoice in the list to open it.
+
+
+
+Here you can view all the details relevant to your invoice, and the specific actions you can perform.
+
+Click the “Release” button.
+
+
+
+This will trigger a prompt with your wallet.
+
+Review the details and click the “Confirm” button to process this transaction and release the funds in escrow for this milestone to your contractor.
diff --git a/packages/website/docs-v3/tutorials/client/use-a-multisig-wallet-as-client.md b/packages/website/docs-v3/tutorials/client/use-a-multisig-wallet-as-client.md
new file mode 100644
index 00000000..7b23ed8d
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/client/use-a-multisig-wallet-as-client.md
@@ -0,0 +1,170 @@
+---
+title: How to use a multisig wallet as a client
+---
+
+Using a multisig (multi-signature) wallet provides an additional layer of security in blockchain transactions. A multisig requires more than signer to sign a transaction for the transaction to confirm.
+
+This mechanism provides multiple benefits:
+
+1) If one address’s private key is compromised, a multisig ensures a hacker cannot drain the wallet of funds.
+2) If the funds are mutually owned by a larger organization, a multisig ensures that one party cannot unilaterally spendl the funds in the wallet.
+
+Smart Invoice recommends using Gnosis Safe as a time-tested, intuitive, and safe multisig wallet. For larger projects involving significant funds, a multisig adds compelling transparency and security.
+
+Smart Invoice is configured to use Gnosis Safe as an integrated Safe app.
+
+### Creating a multisig with Gnosis Safe:
+
+1. Navigate to gnosis-safe.io and click ‘Open app’.
+
+
+
+2. Assuming you don’t already have a multisig setup, click ‘Create Safe’.
+
+
+
+3. Connect your wallet to Gnosis Safe. Your wallet provider will pop up on clicking ‘Connect’ and ask you to approve the account and connection.
+
+
+
+4. Click here to select the chain for your multisig.
+
+
+
+5. Select your chain.
+
+**PLEASE CONFIRM THIS IS THE CHAIN NETWORK AS YOUR INVOICE.**
+
+
+6. Add all the addresses of the multisig owners. Click ‘Add another owner’ to keep adding additional owners. These are the only addresses that will be able to sign transactions for the multisig.
+
+The first address will always be the wallet that is currently connected to Gnosis Safe.
+
+**PLEASE CHECK AND VERIFY THAT THE OWNERS ADDRESSES ARE ACCURATE.**
+
+
+7. Select how many owners must sign the transaction for that transaction to process.
+
+This is the essential function of the multisig so consider this option carefully.
+
+As in most cases, security and convenience are mutually exclusive tradeoffs in using a multisig. The most common multisig setup has three owners, while requiring two of those owners to sign transactions. The more owners a wallet has, and the more of those owners that are required to sign a transaction for that transaction to process, then the more secure that multisig will be.
+
+However, the more required signers then consequently the potentially slower it will be to process transactions (especially if you are using the Gnosis Apps portal to interact with Smart Invoice, which is covered below).
+
+
+
+8. Confirm the safe name, required number of signers, and owners addresses are correct. Click ‘Create’.
+
+
+
+9. Make sure to fund your multisig. Copy the multisig address here.
+
+Gnosis Safe automatically inserts a helper chain prefix (in this case ‘rin:’ as this safe is on the Rinkeby test network) to the address. Make sure to delete this prefix when you paste the address into your wallet to send funds.
+
+
+
+### Adding Smart Invoice as a Custom App to Gnosis Safe
+
+Gnosis Safe supports an intuitive platform for interacting with apps using your Gnosis Safe multisig. Likewise Smart Invoice is configured to use Gnosis Safe’s Apps platform.
+
+In order to use Smart Invoice using your multisig from within Gnosis Safe follow the below steps:
+
+1. Choose ‘Apps’ from the sidebar of the homescreen.
+
+
+
+2. Click ‘Add custom app’. Smart Invoice is in the process of becoming a trusted Safe app, and will appear in the default list after confirmation.
+
+
+
+3. Paste https://app.smartinvoice.xyz/ in the field for the url. Make sure you do not copy the website address to this field (https://smartinvoice.xyz/), otherwise an error will appear (‘Failed to fetch app manifest’).
+
+
+
+4. After adding the Smart Invoice logo and name should automatically populate. Click the checkbox and ‘Add’.
+
+
+
+5. Several screens will appear asking you to confirm you are interacting with a third party app. Click through and agree. At the end, you will Smart Invoice within a Gnosis Safe app interface. From here you can interact with Smart Invoice from your multisig.
+
+
+
+6. The next time you open Gnosis Safe, Smart Invoice will be saved as a custom app under the Apps header in the sidebar.
+
+
+
+### Interacting with Smart Invoice using a Gnosis Safe multisig as the Client
+
+1. Navigate to the Apps tab in the sidebar on the Gnosis Safe home screen. If you followed the above steps to add Smart Invoice to Gnosis Safe, Smart Invoice will appear as a custom app. Click on it. You will get several pop ups warning you will be interacting with an outside app.
+
+Click through all of the pop ups and you will arrive at Smart Invoice within the Gnosis Safe wrapper.
+
+
+
+2. We will demonstrate making a deposit to an existing invoice using your multisig wallet.
+
+As service providers will almost always be the ones creating the invoice, please ensure you give them your multisig address in order for your organization to pay with your Gnosis Safe Wallet and interact with Smart Invoice as the Client.
+
+**Make sure you are signed into your wallet provider, using an owner address and on the same network as the invoice.**
+
+Navigate to the invoice page and click ‘Deposit’.
+
+
+
+3. Choose the amount you want to deposit. This amount can be a milestone amount, or any arbitrary amount of the chosen token. Click ‘Deposit’ on the pop up.
+
+
+
+4. Another confirmation modal will pop up, this time from Gnosis Safe.
+
+**If you are not signed in, using an owner address or on the same network as the invoice you will get an error.**
+
+Click ‘Submit’.
+
+
+
+5. Sign the transaction in your wallet provider.
+
+
+
+6. **IMPORTANT NOTE: On submission the modal will appear to submit and a spinner will appear. Using a multisig, this spinner will not resolve as the required number of owners have not yet signed for the transaction to complete.**
+
+**Everything is working normally.**
+
+
+
+7. Your transaction has now been placed in the transaction queue in Gnosis Safe.
+
+From the Smart Invoice app page, a transaction queue notification will appear at the bottom of the screen. You can also reach pending transactions from the Transactions tab in the sidebar.
+
+
+
+8. The Transactions page will list all pending transactions. Make sure you process pending transactions in order (the ‘nonce’ is the transaction number). Gnosis Safe will alert you to this fact as well.
+
+
+
+9. One or more multisig owners will then need to navigate to this page and click on the next pending transaction.
+
+‘Confirmations’ will show how many more signers are needed for the transaction to process.
+
+Click ‘Confirm’.
+
+
+
+10. The ‘Approve Transaction’ modal will pop up. Click ‘Submit’.
+
+
+
+11. Sign the transactions from your wallet provider prompt.
+
+12. The transaction will take anywhere from a couple seconds to several minutes to process depending on the network.
+
+13. After the transaction completes, Gnosis Safe will display the successful transaction. This transaction can be viewed at any time in ‘History’ in the Transactions tab in the sidebar.
+
+
+
+14. If you navigate back to the invoice page, you will see that the Smart Invoice interface registers your deposit.
+
+*Note: The invoice displays ‘Partially Deposited’ as we only deposited a very small amount of test eth in this test case. This message has nothing to do with Gnosis Safe or multisig use.*
+
+
\ No newline at end of file
diff --git a/packages/website/docs-v3/tutorials/client/view-invoices.md b/packages/website/docs-v3/tutorials/client/view-invoices.md
new file mode 100644
index 00000000..ec284210
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/client/view-invoices.md
@@ -0,0 +1,21 @@
+---
+title: How to view invoices sent to your wallet
+---
+
+Navigate to app.smartinvoice.xyz.
+
+
+
+To use Smart Invoice, you will need to connect your cryptocurrency wallet to the site. Make sure to use the wallet address you provided to your contractor when they configured the invoice.
+
+If a prompt doesn't automatically appear, click the "View Existing Invoices" button to trigger it.
+
+
+
+Click on the wallet tool you want to use.
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
\ No newline at end of file
diff --git a/packages/website/docs-v3/tutorials/contractor/accept-payments-to-multisig-wallet.md b/packages/website/docs-v3/tutorials/contractor/accept-payments-to-multisig-wallet.md
new file mode 100644
index 00000000..62848795
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/accept-payments-to-multisig-wallet.md
@@ -0,0 +1,13 @@
+---
+title: How to accept payments to your multisig wallet
+---
+
+We currently recommend using Gnosis Safe if you choose to use a multisig wallet. Gnosis Safe is intuitive to use, serves all the major networks, and has a solid track record as a secure multisig option.
+
+Receiving payments on a multisig is the same receiving funds on any other wallet.
+
+**However!**
+
+It is difficult to get the same multisig wallet address on different chains. Therefore be aware if you set your client address to a multisig that is on a different chain than your invoice. It is not assured you will be able to reproduce that address on the invoice’s chain.
+
+**You must confirm that the your multisig address is on the same chain as the invoice before you create the invoice.**
diff --git a/packages/website/docs-v3/tutorials/contractor/add-more-milestones-to-existing-invoice.md b/packages/website/docs-v3/tutorials/contractor/add-more-milestones-to-existing-invoice.md
new file mode 100644
index 00000000..cc02029f
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/add-more-milestones-to-existing-invoice.md
@@ -0,0 +1,29 @@
+---
+title: How to add more milestones to an existing invoice as a contractor
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+To open an invoice, you can click on the invoice in the list, or you can click the 3 dots next to your invoice in the “Action” column and click “Manage”.
+
+This will bring up your invoice.
+
+
+
+Click the blue “Add Milestones” button at the top right.
+
+
+
+This will open up a new prompt where you can add in the total payment amount you wish to add to the invoice, along with the additional number of payment milestones you want to add.
+
+Once complete, click the “Add” button.
+
+
+
+This will trigger your wallet to open a prompt you need to sign.
+
+Review the details and then click the “Confirm” button to update your invoice with these new payment milestones.
diff --git a/packages/website/docs-v3/tutorials/contractor/check-invoice-status.md b/packages/website/docs-v3/tutorials/contractor/check-invoice-status.md
new file mode 100644
index 00000000..ef5892d0
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/check-invoice-status.md
@@ -0,0 +1,20 @@
+---
+title: How to check the status of an invoice
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+Next to each invoice you will see the status of that invoice.
+
+**Possible statuses included:**
+
+- Awaiting Deposit (the client needs to fund the escrow)
+- Funded (escrow has been funded and you can begin work)
+- Completed (all milestone payments have been released from escrow)
+- Expired (the invoice has passed the Safety Valve Date and the client can retrieve funds in escrow)
+- In dispute (escrow has been locked and disputed funds will be released by the arbitrator)
+- Dispute Resolved (disputed funds have been released by the arbitrator)
diff --git a/packages/website/docs-v3/tutorials/contractor/custom-arbitrator.md b/packages/website/docs-v3/tutorials/contractor/custom-arbitrator.md
new file mode 100644
index 00000000..33eb0ccd
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/custom-arbitrator.md
@@ -0,0 +1,15 @@
+---
+title: How to add a custom arbitrator
+---
+
+Currently Smart Invoice uses Kleros as a trusted arbitration provider with a history of fairly resolving disputes.
+
+However you can choose to use your own arbitrator if you wish. You will be prompted to enter an Arbitration Provider Address while creating your invoice on Step 2: Payment Details.
+
+
+
+You must confirm the arbitrator address is correct, and that your chosen arbitrator has access to this address. Otherwise, if the invoice is in dispute and locked, these funds will be unreachable until after the Safety Valve date.
+
+This arbitrator address will be the only who can award the client and/or provider the disputed funds if the invoice is in dispute.
+
+Currently the arbitrator is awarded 5% of the disputed amount for their arbitration services.
diff --git a/packages/website/docs-v3/tutorials/contractor/download-invoice-to-pdf.md b/packages/website/docs-v3/tutorials/contractor/download-invoice-to-pdf.md
new file mode 100644
index 00000000..adc71639
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/download-invoice-to-pdf.md
@@ -0,0 +1,13 @@
+---
+title: How to download a PDF of your invoice as a contractor
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+Click the 3 dots next to your invoice in the “Action” column.
+
+Then click the “Download” option from the prompt. This will begin the download process of your PDF invoice to your computer.
diff --git a/packages/website/docs-v3/tutorials/contractor/encrypt-project-agreement.md b/packages/website/docs-v3/tutorials/contractor/encrypt-project-agreement.md
new file mode 100644
index 00000000..137d8b4e
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/encrypt-project-agreement.md
@@ -0,0 +1,7 @@
+---
+title: How to encrypt the project agreement
+---
+
+Smart Invoice doesn’t currently offer in-platform encryption of the project agreement (although this is a projected future feature).
+
+If you wish to encrypt your project agreement we recommend using DocuSign as the most secure method to password protect your project agreement PDF.
\ No newline at end of file
diff --git a/packages/website/docs-v3/tutorials/contractor/how-to-create-an-invoice.md b/packages/website/docs-v3/tutorials/contractor/how-to-create-an-invoice.md
new file mode 100644
index 00000000..f7f1a594
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/how-to-create-an-invoice.md
@@ -0,0 +1,84 @@
+---
+title: How to create an invoice
+---
+
+Once your wallet is connected to Smart Invoice, click the “Create Invoice” button.
+
+
+
+This will open the multi-step form to create the invoice.
+
+
+
+In Step 1, you will need to add the project details for this invoice.
+
+**Project Title:**
+Choose something easily identifiable by you & your client. This is how the invoice will appear on your sortable invoices list later.
+
+**Project Description:**
+This brief description will help you and your client remember key project details in the future.
+
+**Link to Project Agreement:**
+This agreement will be referenced if there is a payment dispute that goes to arbitration. Link a file that cannot be modified. This data will be stored publicly on IPFS and can be viewed by anyone. If you have privacy concerns, we recommend adding permissions to this agreement so it’s encrypted and only you and your client can view it.
+
+**Project Start Date:**
+This is the date you expect to begin work on this project.
+
+**Expected End Date:**
+This is the date you expect to complete work on this project.
+
+**Safety Valve Date:**
+If you do not complete this project by this date, your client can withdraw deposited funds in escrow after 00:00:00 GMT on this date. (Add extra time after the expected end date, in case things take longer to complete).
+
+
+
+In Step 2, you will add your payment details for the invoice.
+
+**Client Address:**
+This is the wallet address your client uses to access the invoice, pay with, & release escrow funds with. It’s essential your client has control of this address. (Only use a multisig wallet if the client has followed these instructions). You will need to request this wallet address from your client directly. Then paste it here.
+
+**Service Provider Address:**
+This is your wallet address. It’s how you access this invoice & where you’ll receive funds released from escrow. It’s essential you have control of this address. (Only use a multisig wallet if you understand the process listed here).
+
+**Arbitration Provider:**
+This arbitrator will be used in case of dispute. Kleros is recommended, but you may include the wallet address of your preferred arbitrator.
+
+**Potential Dispute Fee:**
+If a disputed milestone payment goes to arbitration, 5% of that milestone’s escrowed funds are automatically deducted as an arbitration fee to resolve the dispute.
+
+**Tickbox:**
+You will need to tick the box to accept the arbitration provider's terms of service.
+
+
+
+In Step 3, you will list out the payment amount for each milestone.
+
+**Payment Token:**
+This is the cryptocurrency you’ll receive payment in. This number is not based on fiat, but rather the number of tokens you’ll receive in your chosen cryptocurrency. (e.g. 7.25 WETH, 100 USDC, etc). The network your wallet is connected to determines which tokens display here. (If you change your wallet network now, you’ll be forced to start the invoice over).
+
+**Milstones:**
+ Use the drop-down arrows to customize the description and amount of each milestone. You can add as many milestones as you want; it’s a good idea to have smaller milestones to complete so that you can maintain cash flow throughout your project, and avoid scope creep.
+
+
+
+In Step 4, you will create your invoice.
+
+Review the details of the invoice to ensure everything is correct.
+
+If you find any errors, go back to the previous steps and make the necessary modifications.
+
+When you are ready to create the invoice, click the “Create Invoice” button.
+
+
+
+A prompt will appear from your wallet. Review the details and then click the “Confirm” button to finalize creation of your invoice on-chain. There will be a small gas fee to sign this transaction and complete the invoice.
+
+
+
+Within a few minutes the invoice will be created and registered by the system.
+
+You can view the on-chain transaction by clicking the provided link.
+
+Smart Invoice will display Invoice ID and a link to view it.
+
+Copy this link and give it to your client. That is where they will be able to deposit funds.
diff --git a/packages/website/docs-v3/tutorials/contractor/lock-milestone-and-request-arbitration.md b/packages/website/docs-v3/tutorials/contractor/lock-milestone-and-request-arbitration.md
new file mode 100644
index 00000000..b0e9147a
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/lock-milestone-and-request-arbitration.md
@@ -0,0 +1,21 @@
+---
+title: How to lock a milestone and request arbitration if there is a dispute
+---
+
+Navigate to the invoice you want to lock.
+
+
+
+If there are any milestones that have been funded via escrow, but payments have not yet been released to your wallet address, you can click the “lock” button.
+
+This will display a prompt where you can enter the details of your dispute. These details will be sent to the arbitrator you selected during the invoice creation process.
+
+
+
+Click the “Lock” button to begin the arbitration process.
+
+Now your arbitrator will see the details of your dispute inside of their Smart Invoice account, and can determine who to release funds to.
+
+It is essential that you contact your chosen arbitrator manually (email, text, DM, etc) to notify them about the dispute. Then they can log into Smart Invoice to manage this dispute.
+
+Note: Smart Invoice does not notify the arbitrator about the dispute. They will see it in their Smart Invoice account, but you need to notify them to log into their account.
diff --git a/packages/website/docs-v3/tutorials/contractor/manage-invoices.md b/packages/website/docs-v3/tutorials/contractor/manage-invoices.md
new file mode 100644
index 00000000..938e3a51
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/manage-invoices.md
@@ -0,0 +1,17 @@
+---
+title: How to manage invoices as a contractor
+---
+
+Once your wallet is connected to Smart Invoice, click the “Dashboard” link at the top of the page.
+
+This will display a list of all of your invoices.
+
+
+
+Click on an invoice in the list to open it.
+
+
+
+Here you can view all the details relevant to your invoice, and the specific actions you can perform.
+
+As a contractor you can add milestones, download a PDF of the invoice, and lock the invoice.
diff --git a/packages/website/docs-v3/tutorials/contractor/request-deposit.md b/packages/website/docs-v3/tutorials/contractor/request-deposit.md
new file mode 100644
index 00000000..a55a7729
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/request-deposit.md
@@ -0,0 +1,9 @@
+---
+title: How to request a deposit to escrow from your client
+---
+
+Once you have configured your invoice and are ready for the client to fund the initial milestone payment through escrow, you will need to manually notify your client.
+
+The client can log into smartinvoice.xyz with the wallet address you linked to the invoice during the invoice creation process. From there, they will be able to see the invoice you created and they can follow the instructions here in the documentation to fund the first milestone.
+
+The other option is to navigate to the invoice details page inside of Smart Invoice (by following the instructions here), and then copying the url to this page from your browser and sending it to your client. Then your client will be able to log into Smart Invoice and click the “Deposit” button inside of your invoice.
\ No newline at end of file
diff --git a/packages/website/docs-v3/tutorials/contractor/request-milestone-payments-released-from-escrow.md b/packages/website/docs-v3/tutorials/contractor/request-milestone-payments-released-from-escrow.md
new file mode 100644
index 00000000..7bfa82c8
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/request-milestone-payments-released-from-escrow.md
@@ -0,0 +1,9 @@
+---
+title: How to request milestone payments be released from escrow
+---
+
+After you’ve completed the work associated with a milestone, you can request funds be released from escrow.
+
+This is a manual process, and you will need to notify your client.
+
+Your client will log into their Smart Invoice account with the wallet linked to the invoice, and navigate to the invoice. They will click a blue button labeled “Release” and create the transaction to deliver the milestone payment from the escrow to your wallet address.
diff --git a/packages/website/docs-v3/tutorials/contractor/verify-client-wallet-address.md b/packages/website/docs-v3/tutorials/contractor/verify-client-wallet-address.md
new file mode 100644
index 00000000..cabcfac1
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/contractor/verify-client-wallet-address.md
@@ -0,0 +1,31 @@
+---
+title: How to verify client's wallet address
+---
+
+Please take all precautions before creating an invoice to double check that all information (**especially** client, provider and arbitrator addresses) is accurate. After the invoice is created this information cannot be changed. The only addresses able to interact with the invoice once it is on-chain will be the client, provider and, to a more limited extent, the arbitrator.
+
+Client address verification is a safety feature to ensure extraneous funds are not lost to the contract.
+
+Before any deposits are allowed from any address except the client address, the client address must verify that they have access to that address by sending an extremely small on-chain transaction.
+
+Before the client has verified their address, all other addresses will be unable to deposit on the invoice page:
+
+
+
+If you are the client, you must follow these steps to enable non-client deposits:
+
+1) Make sure you are using your client address and navigate to the invoice page.
+
+2) Click on ‘Enable Non-Client Account Deposits’.
+
+
+
+3) You will be prompted to sign a transaction from your wallet provider. The verify transaction uses the smallest possible amount of gas, so the transaction cost will be extremely small.
+
+If you have successfully signed the transaction you will see the enable button change to a spinner:
+
+
+
+4) Once the transaction is confirmed on-chain, ‘Not Enabled’ will update to ‘Enabled!’. Non-client accounts can now deposit to the invoice contract.
+
+
diff --git a/packages/website/docs-v3/tutorials/sidebars.js b/packages/website/docs-v3/tutorials/sidebars.js
new file mode 100644
index 00000000..cbf8bcb9
--- /dev/null
+++ b/packages/website/docs-v3/tutorials/sidebars.js
@@ -0,0 +1,130 @@
+export const docV3Menu = [
+ {
+ category: 'Getting Started',
+ path: 'getting-started',
+ topics: [
+ {
+ title: 'What is Smart Invoice?',
+ slug: 'what-is-smart-invoice'
+ },
+ {
+ title: 'Who should use Smart Invoice?',
+ slug: 'who-should-use-smart-invoice'
+ },
+ {
+ title: 'How do I log in?',
+ slug: 'how-do-i-log-in'
+ },
+ {
+ title: 'What is escrow?',
+ slug: 'what-is-escrow'
+ },
+ {
+ title: 'What is arbitration and “locking”?',
+ slug: 'what-is-locking-and-arbitration'
+ },
+ ],
+ },
+ {
+ category: 'Contractor Tutorials',
+ path: 'tutorials/contractor',
+ topics: [
+ {
+ title: "How to create an invoice",
+ slug: 'how-to-create-an-invoice'
+ },
+ {
+ title: "How to encrypt the project agreement",
+ slug: 'encrypt-project-agreement'
+ },
+ {
+ title: "How to accept payments to your multisig wallet",
+ slug: 'accept-payments-to-multisig-wallet'
+ },
+ {
+ title: "How to verify your client’s wallet address",
+ slug: 'verify-client-wallet-address'
+ },
+ {
+ title: "How to add a custom arbitrator",
+ slug: 'custom-arbitrator'
+ },
+ {
+ title: "How to request a deposit to escrow from your client",
+ slug: 'request-deposit'
+ },
+ {
+ title: "How to manage your invoices",
+ slug: 'manage-invoices'
+ },
+ {
+ title: "How to request milestone payments be released from escrow",
+ slug: 'request-milestone-payments-released-from-escrow'
+ },
+ {
+ title: "How to add more milestones to an existing invoice",
+ slug: 'add-more-milestones-to-existing-invoice'
+ },
+ {
+ title: "How to download a PDF of your invoice",
+ slug: 'download-invoice-to-pdf'
+ },
+ {
+ title: "How to check the status of an invoice",
+ slug: 'check-invoice-status'
+ },
+ {
+ title: "How to lock a milestone and request arbitration if there is a dispute",
+ slug: 'lock-milestone-and-request-arbitration'
+ },
+ ],
+ },
+ {
+ category: 'Client Tutorials',
+ path: 'tutorials/client',
+ topics: [
+ {
+ title: "How to view invoices sent to your wallet",
+ slug: 'view-invoices'
+ },
+ {
+ title: "How to deposit funds into the invoice’s escrow",
+ slug: 'deposit-funds'
+ },
+ {
+ title: "How to release escrow funds held inside of a milestone",
+ slug: 'release-escrow-funds-inside-milestone'
+ },
+ {
+ title: "How to pay invoices with a multisig wallet",
+ slug: 'use-a-multisig-wallet-as-client'
+ },
+ {
+ title: "How to lock a milestone and request arbitration if there is a dispute",
+ slug: 'lock-milestone-and-request-arbitration'
+ },
+ {
+ title: "How to download a PDF of your invoice",
+ slug: 'download-invoice-as-pdf'
+ },
+ ]
+ },
+ {
+ category: 'Miscellaneous',
+ path: 'misc',
+ topics: [
+ {
+ title: 'Get Support',
+ slug: 'get-support'
+ },
+ {
+ title: 'Troubleshooting',
+ slug: 'troubleshooting'
+ },
+ {
+ title: 'FAQ',
+ slug: 'FAQ'
+ }
+ ]
+ },
+]
\ No newline at end of file
diff --git a/packages/website/next.config.js b/packages/website/next.config.js
new file mode 100644
index 00000000..ce404e70
--- /dev/null
+++ b/packages/website/next.config.js
@@ -0,0 +1,10 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+ reactStrictMode: true,
+ swcMinify: true,
+ env: {
+ GETFORM_URL: process.env.GETFORM_URL
+ }
+};
+
+module.exports = nextConfig;
diff --git a/packages/website/package.json b/packages/website/package.json
new file mode 100644
index 00000000..d923c65a
--- /dev/null
+++ b/packages/website/package.json
@@ -0,0 +1,30 @@
+{
+ "name": "@smartinvoicexyz/website",
+ "version": "0.1.0",
+ "dependencies": {
+ "@chakra-ui/react": "^2.8.2",
+ "@emotion/react": "^11.13.3",
+ "@emotion/styled": "^11.13.0",
+ "framer-motion": "^11.5.6",
+ "gray-matter": "^4.0.3",
+ "marked": "^4.1.1",
+ "next": "^14.2.13",
+ "react": "^18.2.0",
+ "react-dom": "^18.2.0",
+ "remark": "^14.0.2",
+ "remark-html": "^15.0.1"
+ },
+ "devDependencies": {
+ "@next/eslint-plugin-next": "^14.2.7",
+ "eslint": "8.56.0",
+ "eslint-config-next": "^14.2.7"
+ },
+ "private": true,
+ "scripts": {
+ "build": "next build",
+ "dev": "next dev",
+ "lint": "next lint",
+ "start": "next start",
+ "typecheck": "tsc --noEmit"
+ }
+}
diff --git a/packages/website/pages/_app.jsx b/packages/website/pages/_app.jsx
new file mode 100644
index 00000000..67de1430
--- /dev/null
+++ b/packages/website/pages/_app.jsx
@@ -0,0 +1,16 @@
+import '../styles/globals.css';
+
+import { ChakraProvider } from '@chakra-ui/react';
+import React from 'react';
+
+import { theme } from '../theme';
+
+function MyApp({ Component, pageProps }) {
+ return (
+