Skip to content

Commit 4de6596

Browse files
g1-ghutzgitbook-bot
authored andcommitted
GITBOOK-1065: Adding Matt's vendor processes - Signing SC and MAF evidence
1 parent b574719 commit 4de6596

File tree

4 files changed

+161
-1
lines changed

4 files changed

+161
-1
lines changed

SUMMARY.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,9 @@
6868
* [Administrating Treasury funding](cardano-facilitation-services/cardano-budget/README.md)
6969
* [Intersect Administration Services](cardano-facilitation-services/cardano-budget/intersect-administration-services/README.md)
7070
* [Intersect as an Administrator](cardano-facilitation-services/cardano-budget/intersect-administration-services/intersect-as-an-administrator.md)
71-
* [Onboarding & Vendor Information](cardano-facilitation-services/cardano-budget/intersect-administration-services/onboarding-and-vendor-information.md)
71+
* [Onboarding & Vendor Information](cardano-facilitation-services/cardano-budget/intersect-administration-services/onboarding-and-vendor-information/README.md)
72+
* [How to sign your Vendor Smart Contract](cardano-facilitation-services/cardano-budget/intersect-administration-services/onboarding-and-vendor-information/how-to-sign-your-vendor-smart-contract.md)
73+
* [How to submit Milestone Evidence and Withdraw Milestones](cardano-facilitation-services/cardano-budget/intersect-administration-services/onboarding-and-vendor-information/how-to-submit-milestone-evidence-and-withdraw-milestones.md)
7274
* [Ratification, Enactment, and Smart Contract Creation](cardano-facilitation-services/cardano-budget/intersect-administration-services/ratification-enactment-and-smart-contract-creation.md)
7375
* [Smart contracts as part of our Administration](cardano-facilitation-services/cardano-budget/intersect-administration-services/smart-contracts-as-part-of-our-administration/README.md)
7476
* [Smart contract types](cardano-facilitation-services/cardano-budget/intersect-administration-services/smart-contracts-as-part-of-our-administration/smart-contract-types.md)

cardano-facilitation-services/cardano-budget/intersect-administration-services/onboarding-and-vendor-information.md renamed to cardano-facilitation-services/cardano-budget/intersect-administration-services/onboarding-and-vendor-information/README.md

File renamed without changes.
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
# How to sign your Vendor Smart Contract
2+
3+
Following on-chain governance action voting and the signing of a traditional legal contract, the last administrative step in setting up your delivery is to sign the Smart Contract version of your Contract. 
4+
5+
This commits your project and delivery schedule; milestone name, deliverable, payment date and amount, immutably to the Cardano blockchain. This metadata and any subsequent agreed changes will be publicly available. 
6+
7+
Please carefully read each of the 3 steps outlined below and complete the signing of your vendor smart contract. 
8+
9+
This must be completed within 36 hours of the smart contract being deployed by Intersect.
10+
11+
## Step 1:
12+
13+
Navigate to the Smart Contract Administration Dashboard, URL: [https://treasury.sundae.fi/instances](https://treasury.sundae.fi/instances) and Log In using the wallet/credential that you provided within your legal contract. 
14+
15+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdmF8079Rh_-ToJUJP6l0xNlEavwUSOLdwSf9Gy9v3J6fYAXU4gXF0OnlgZa8hPgodj-MwO6DkBJX9lP9TD_DuZYi366_888rDMBGKOn3jc5-yI4UdNB52X7VJkosJIpnlorfoU1g?key=gNhitpaJ0in5rp_SHZ18XA" alt=""><figcaption></figcaption></figure>
16+
17+
## Step 2:
18+
19+
Navigate to your vendor smart contract. The ‘Contract Name’ will be similar or an abbreviated version of your legal contract name.&#x20;
20+
21+
In some cases where a vendor has multiple successful projects the name may be a combination of all successful project names. Also longer projects may be broken down into smaller smart contracts (the vendor will have one legal contract and multiple smart contracts), in these instances the project names should be agreed in advance.
22+
23+
Outstanding or pending actions will also be highlighted once signed into the administration dashboard. The UI may show this in multiple ways:
24+
25+
* Highlighted to the right under ‘Your Action Items’, highlighted below in red
26+
* ‘Action Items’ in the main navigation panel to the left
27+
28+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdnAJPEJ6ryv29QhyxyblOAA4uhDM8qseupIuR0PFatS_7FooUCVMkqp73_o0sfeNomk3MD3pIh7nj87jkcvswsXHiUYS0TQGv--XcN3tN_Vkxg2avVOsnJ-U4NEvVT1HYxxqO4zw?key=gNhitpaJ0in5rp_SHZ18XA" alt=""><figcaption></figcaption></figure>
29+
30+
## Step 3:
31+
32+
Click on the button to ‘Review Transaction’, highlighted green below.
33+
34+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXce65u0aZz8Po87L6MX0CGnJE0x0k3kkoBMN4biuIeo_D2VN4QtAoOvzpCYgOkoE3WZxtz0VfNVgO3gAFotmUrSFE2LnpaT2nUpAy0YyleUqn7lH-lUq6x7pIMQwHDg0ga0r6jYGg?key=gNhitpaJ0in5rp_SHZ18XA" alt=""><figcaption></figcaption></figure>
35+
36+
\
37+
Please ensure you check all the details of the smart contract, Project Name, Project Description and the delivery schedule; milestone name, deliverable, payment date and amount, highlighted green below.
38+
39+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf6dM0SKEEokOoiy1gHHeN3-JnEhHzRAtZJm04EgAbbIxx2GASt0fI6zXeToYwxi_2aBoAbrA57x7kUgkxfTWVgr9n9Al6ZNs7kInwreugJ7lnJYXfVU5mCM_KHq77VAGQY8fHV7Q?key=gNhitpaJ0in5rp_SHZ18XA" alt=""><figcaption></figcaption></figure>
40+
41+
\
42+
If you have multiple smart contracts you will see multiple actions, these should all be completed individually.&#x20;
43+
44+
Note: currently the smart contract will only contain milestone payment date, not milestone delivery date.&#x20;
45+
46+
If the information **IS CORRECT** - sign the action per the administration dashboard prompts, highlighted orange above.&#x20;
47+
48+
If the information **IS NOT** correct - do nothing on the administration dashboard, do not sign the contract. Alert the Intersect Delivery Assurance team via the communication channels established with you as a vendor or email the team at [[email protected]](mailto:[email protected]).
49+
50+
Please detail the issues or discrepancies found.&#x20;
51+
52+
The action request to sign your vendor smart contract will be available for 36 hours following deployment, if you do not sign your contract within this period the process will need to be restarted and the request sent again.
53+
54+
**End of Instructions.**&#x20;
55+
56+
57+
58+
Additional Information:
59+
60+
Where practical and possible on-chain smart contracts will be used to manage your proposals treasury funds. The following information will help you understand how smart contracts are used as part of Intersects Administration.
61+
62+
* Smart Contract Dashboard -[ https://treasury.sundae.fi/](https://treasury.sundae.fi/)
63+
* [Smart Contracts and Cardano budgets blog](https://www.intersectmbo.org/news/%EF%B8%8F-smart-contracts-and-cardano-budgets)
64+
* [Smart Contracts as part of Intersects Administration Knowledge Base](https://docs.intersectmbo.org/cardano-facilitation-services/cardano-budget/intersect-administration-services/smart-contracts-as-part-of-our-administration)
65+
* [Treasury Oversight Management Video by SundaeLabs](https://www.youtube.com/watch?v=S6RFKzmAebo)
66+
Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
# How to submit Milestone Evidence and Withdraw Milestones
2+
3+
At this point your vendor smart contract should already be deployed and active.&#x20;
4+
5+
Your vendor smart contract commits your project and delivery schedule; milestone name, deliverable, payment date and amount, immutably to the Cardano blockchain. This metadata and any subsequent agreed changes will be publicly available.&#x20;
6+
7+
The following instructions will step you through how to submit evidence and withdraw a milestone payment.&#x20;
8+
9+
These instructions can only be completed by the credential associated with your vendor smart contract.&#x20;
10+
11+
## Step 1:
12+
13+
In your pre-agreed communication channel with the Intersect Delivery Assurance team, vendors should provide a completed Milestone Acceptance Form (MAF) for each individual milestone on or before the **Milestone Completion Date** as set out in your legal contract.&#x20;
14+
15+
_**Best practice tip:**_ It is advised to template these MAFs out for each milestone in advance, share them and work on them in transparency with the delivery assurance team. Intersect may be able to provide feedback throughout the process, not just at the end, this is likely to speed up the review and acceptance process.&#x20;
16+
17+
The delivery assurance team will review and provide acceptance that the attestation provided in the MAF meets the deliverables and acceptance criteria from your legal contract.
18+
19+
If accepted:&#x20;
20+
21+
* The delivery assurance team will host your MAF and provide a link to your completed MAF. This link will be used later when submitting evidence on-chain. Continue to step 2.
22+
23+
(Optionally, if agreed with the delivery assurance team, the vendor may host and provide a link to the completed MAF themselves)
24+
25+
If **not** accepted or a MAF has not been provided by the Milestone Completion date:
26+
27+
* The delivery assurance team will provide feedback as to why the MAF is not acceptable and provide remediation steps for the vendor to compete
28+
* If a MAF is not provided at all the delivery assurance team will recommend that the current and all future milestones be paused
29+
30+
## Step 2:
31+
32+
Navigate to the Smart Contract Administration Dashboard, URL: [https://treasury.sundae.fi/instances](https://treasury.sundae.fi/instances) and Log In using the wallet/credential that you provided within your legal contract.&#x20;
33+
34+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcg7hXSC20_Jbfyv2N0dtcJSaogQviglC6OjnAsriAh1UjjIme3LNBQ5Iknpgp3mLUswZhjsguZqvB1XLe5LP082Dyq1_rJxd92t7MAAkRz1q1laS4iHYBJBR_MNn4XWRKMfn9i?key=aqi7BCFOfE-J3aVJptAoVQ" alt=""><figcaption></figcaption></figure>
35+
36+
## Step 3:
37+
38+
Navigate to your vendor smart contract. The ‘Contract Name’ will be similar or an abbreviated version of your legal contract name.&#x20;
39+
40+
In some cases where a vendor has multiple successful projects the name may be a combination of all successful project names. Also longer projects may be broken down into smaller smart contracts (the vendor will have one legal contract and multiple smart contracts), in these instances the project names should be agreed in advance.
41+
42+
Smart contracts where your credential has available actions will be highlighted:
43+
44+
* Example of a claimable milestone. ‘Instances’ > ‘Intersect Treasury Reserve Contracts 1’, highlighted below in green
45+
* Open your vendor smart contract, continue to step 4
46+
47+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdSjbVIGGbsVCrFdvwfB0IsNMgrnLB8RfVJTyISLNnf4Lj3Evu4CfGHU5tW2JqjDleB0tNGGHs8jaCzJaMckWftQb3nwkQZLdbZ5rtGxbk2LEhpkEVITgr29DXM9EU-4F4E2yySBw?key=aqi7BCFOfE-J3aVJptAoVQ" alt=""><figcaption></figcaption></figure>
48+
49+
## Step 4:
50+
51+
Click on the button to ‘Submit Evidence’, highlighted green below.
52+
53+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeXZXK7nS0qjYBy26-SZukR_FXW9u5y9eus7GmSTOMAdOjbh72IjXnmE5XTsm64Qc1v_9sdKv8daVvTz2ZLL5Sqdh1OwEnESXyc5SxBh13cngVM-PiCr5SYbGGo1uB0YjjJCA83Ag?key=aqi7BCFOfE-J3aVJptAoVQ" alt=""><figcaption></figcaption></figure>
54+
55+
Completed the pop-up form.
56+
57+
* Milestone: Select the milestone the evidence is supportive of, as in some instances you have multiple milestones which require evidence being submitted
58+
* Title: Enter an appropriate title for the evidence, you should include the Milestone Number and Name as per your legal contract
59+
* Evidence URL: Enter the link pre-agreed with the Delivery Assurance team from step 1. This URL will point to your completed Milestone Acceptance Form (MAF)
60+
61+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe1E9JvRqi4NknFGF51xmr_5LQtY7N-mPo6HKjIJK4Q2bMZFh2iJucD4dDpCX5szCIBPP_e_lwDyxlcHVhPdpsHHcdRVcEMfsZN2HmFVRREuUyufmsW9i2TwCIg8BqboX-g9JgjIg?key=aqi7BCFOfE-J3aVJptAoVQ" alt=""><figcaption></figcaption></figure>
62+
63+
Once completed click the ‘Submit Evidence’ button. You may be asked to sign a transaction submitting the evidence to on-chain.&#x20;
64+
65+
Failure to submit a MAF on or before the Milestone Completion Date to the delivery assurance team, or failure to submit a form at all, may result in the vendor smart contract Payment Date being paused.&#x20;
66+
67+
Many organisations are still required to submit and process invoices. Please submit invoices within 5 working days of your Milestone Completion Date as per your legal contract, following the instructions within your contract.&#x20;
68+
69+
In certain circumstances failure to submit invoices may also result in your smart contract payment date milestones being paused and ultimately funds may be delayed.&#x20;
70+
71+
## Step 5:
72+
73+
Once evidence has been submitted you may select the option to ‘Withdraw All Available Payments’
74+
75+
<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXesPmDMClzPV-6d67u8tpMCYTnepggzE-knhCnKkUA7WNKoLXS1yZ8Z1cQvnG9b8R-3OXafonORMuFuVKbryeASfqGggnOfaStrWVPH48E5NO6r6TXM4eZDZulA1Y3LfUXy2oSsfQ?key=aqi7BCFOfE-J3aVJptAoVQ" alt=""><figcaption></figcaption></figure>
76+
77+
Follow the actions as prompted to withdraw any milestone payment dates which have matured.&#x20;
78+
79+
Note, withdrawing milestones without providing evidence may result in all subsequent milestones being paused.&#x20;
80+
81+
**End of Instructions.**&#x20;
82+
83+
84+
85+
Additional Information:
86+
87+
Where practical and possible on-chain smart contracts will be used to manage your proposals treasury funds. The following information will help you understand how smart contracts are used as part of Intersects Administration.
88+
89+
* Smart Contract Dashboard -[ https://treasury.sundae.fi/](https://treasury.sundae.fi/)
90+
* [Smart Contracts and Cardano budgets blog](https://www.intersectmbo.org/news/%EF%B8%8F-smart-contracts-and-cardano-budgets)
91+
* [Smart Contracts as part of Intersects Administration Knowledge Base](https://docs.intersectmbo.org/cardano-facilitation-services/cardano-budget/intersect-administration-services/smart-contracts-as-part-of-our-administration)
92+
* [Treasury Oversight Management Video by SundaeLabs](https://www.youtube.com/watch?v=S6RFKzmAebo)

0 commit comments

Comments
 (0)