Merge pull request #34 from stellarcarbon/develop

Release content adjustments and fine print

Author: aolieman

package-lock.json

@@ -9,7 +9,8 @@ export default function GlossaryPage() {
     <div className="flex flex-col">
       <Header>Glossary of key terms</Header>
       <Paragraph>
-        Here you can find explanation of the concepts used on this website.
+        Climate science and carbon accounting can be daunting at first.
+        Let this glossary be your guide.
       </Paragraph>
       <Glossary />
     </div>

public/explain_stellar_verra_integration.png

@@ -11,29 +11,25 @@ export default function ExplainInventoryPage() {
     <div className="flex flex-col">
       <Header>Our token balance</Header>
       <Paragraph>
-        At Stellarcarbon we keep an inventory of VCU credits and{" "}
-        <CARBONCurrencyIcon className="inline" /> tokens. When you sink{" "}
-        <CARBONCurrencyIcon className="inline" />, CarbonSINK tokens are minted
-        and we retire an equal amount of VCU credits in the Verra Registry.
+        At Stellarcarbon we hold an inventory of VCU credits which fully backs
+        the <CARBONCurrencyIcon className="inline" /> in circulation. When
+        you sink <CARBONCurrencyIcon className="inline" />, CarbonSINK tokens 
+        are minted and we retire an equal amount of VCUs in the Verra Registry.
       </Paragraph>
       <Subheader>Current inventory</Subheader>
       <Paragraph className="!pb-0">
-        Have a look at our real-time inventory:
+        Take a look at our real-time inventory summary:
       </Paragraph>
 
       <AuditTable />
 
       <Paragraph>
-        {`Any difference between the inventories on the blockchain and Verra are
-            of temporary nature. As our users sink CARBON, retirement of these tokens is
-             initiated. During
-            this process the VCU's are dedicated to a certificate. Stellarcarbon
-            provides personal certificates as well as a automatic community
-            retirement certificate option.`}
-        <br />
-        <br />
-        Eventually all CARBON pending retirement will be accounted for in these
-        community certificates.
+        Any difference between the inventories on Stellar and Verra is of a 
+        temporary nature. As contributors sink CARBON, retirement of these tokens is
+        initiated. During this process the VCUs are retired into a certificate.
+        Stellarcarbon provides personal certificates as well as an automatic community
+        certificate option. Over time all CARBON pending retirement will be accounted 
+        for in these retirement certificates.
       </Paragraph>
     </div>
   );

public/mozart-pay.png

@@ -11,10 +11,10 @@ export default function ExplainHowItWorks() {
       <Header>How it works</Header>
       <Paragraph>
         When you sink CARBON (<CARBONCurrencyIcon className="inline" />) tokens
-        on Stellarcarbon (either through our web interface or via a single API
-        call) you’re doing two things in one seamless transaction. First, the
+        on Stellarcarbon — either through our dApp or via a single API
+        call — {`you're`} doing two things in one seamless transaction. First, the
         CARBON token is removed from circulation on the Stellar ledger. At the
-        same time, that same transaction creates an on-chain commitment for us
+        same time, that very transaction creates an on-chain commitment for us
         to retire one Verified Carbon Unit (VCU) on the{" "}
         <SCLink href="https://verra.org" target="_blank">
           Verra Registry
@@ -26,21 +26,20 @@ export default function ExplainHowItWorks() {
         Behind the scenes, we maintain a strict 1:1 correspondence between
         CARBON and VCUs (check out our{" "}
         <SCLink href="/explain/how-it-works/inventory">token balance</SCLink>).
-        Every token you burn triggers us to pull an equivalent VCU out of our
+        Every token you sink triggers us to pull an equivalent VCU out of our
         Verra account and “retire” it so it can never be resold. This atomic
-        pairing means your on-chain burn and the off-chain retirement always
-        stay in sync.
+        pairing means the on-chain transactions and the off-chain retirements 
+        always stay linked and in sync.
       </Paragraph>
 
       <div className="py-8">
         <img
           className="max-w-[80%] mx-auto"
           src="/explain_stellar_verra_integration.png"
-          alt="Diagram: burning a CARBON token on Stellar triggers retirement of one Verra VCU"
+          alt="Diagram: sinking a CARBON token on Stellar triggers retirement of one Verra VCU"
         />
         <em className="block text-center text-sm text-tertiary mt-1">
-          Figure: CARBON ↔︎ CarbonSINK on-chain burn paired 1:1 with VCU
-          retirement on Verra
+          CARBON ↔︎ CarbonSINK on-chain sink paired 1:1 with VCU retirement on Verra
         </em>
       </div>
     </div>

src/app/explain/glossary/page.tsx

@@ -11,25 +11,26 @@ export default function ExplainRetirementPage() {
       <Header>Retirement process</Header>
       <Paragraph>
         When users sink <CARBONCurrencyIcon className="inline" />, an equal
-        amount of VCUs in the Verra Registry has to be retired. When retiring
-        VCUs at Verra, a certificate is generated that can be added your
-        personal or business balance sheet to show prove you are offsetting
-        emissions.
+        amount of VCUs in the Verra Registry has to be retired. After retiring
+        VCUs on Verra, a certificate is generated that can be added your
+        personal or business balance sheet to prove you have contributed to
+        global climate goals or have compensated for your own unabated emissions.
       </Paragraph>
-      <Subheader>What is retirement?</Subheader>
+      <Subheader>What is a retirement?</Subheader>
       <Paragraph>
         Retiring a VCU permanently removes it from circulation, turning it from
-        transferable inventory into an exclusive, claimable one-tonne CO₂e
-        reduction on your balance sheet. Until its retired, a VCU remains merely
-        a tradable credit with no impact on anyone’s carbon accounting.
+        transferable inventory into an exclusive, claimable one-ton CO₂e
+        reduction on your balance sheet. Until {`it's`} retired, a VCU remains merely
+        a tradable instrument with no impact on {`anyone's`} carbon accounting.
       </Paragraph>
       <Subheader>Fractional retirements</Subheader>
       <Paragraph>
         Retirement in the Verra Registry only happens in whole units, but
         Stellarcarbon also provides the option to make fractional retirements.
-        We allow users to create a retirement of 1.5 tonnes for example, which
+        We allow users to do a transaction of 1.5 tons for example, which
         is not possible on Verra directly. Stellarcarbon built a mechanism that
-        retires the remaining fractions into a community retirement.
+        retires the fractions that remain pending for some time into a community
+        certificate.
       </Paragraph>
       <div className="py-8">
         <img
@@ -38,7 +39,7 @@ export default function ExplainRetirementPage() {
           alt="retirement process"
         />
         <em className="block text-center text-sm text-tertiary mt-1">
-          Figure: Fractional transactions are eventually retired into a
+          Fractional transactions are eventually retired into a
           community certificate.
         </em>
       </div>

src/app/explain/how-it-works/inventory/page.tsx

@@ -13,41 +13,49 @@ export default function ExplainSinkingProcessPage() {
 
       <Paragraph>
         Our customers can sink <CARBONCurrencyIcon className="inline" /> tokens,
-        meaning they buy the token and immediatly {`"lock it in"`}. This locking
-        means the <CARBONCurrencyIcon className="inline" /> is no longer a
-        tradeable object and the investment into the project is now funded.
+        meaning they buy the token and immediately lock it onto their account. 
+        This locking means the <CARBONCurrencyIcon className="inline" /> is no 
+        longer a tradeable object and the investment into the project is now 
+        funded. The owner of the account on which the balance is locked may 
+        claim the environmental benefit.
       </Paragraph>
 
       <Paragraph>
-        We {`don't`} like the term burn so we use sinking instead.
+        An essential part of the mechanism is that the input{" "}
+        <CARBONCurrencyIcon className="inline" /> is permanently removed from
+        circulation. In cryptocurrency jargon this is also known as {`"token burning"`}.
+        We avoid this phrase because sinking <CARBONCurrencyIcon className="inline" />
+        {" "}causes a reduction of CO₂ in the atmosphere, and no combustion is 
+        involved.
       </Paragraph>
 
-      <Subheader>Sinking</Subheader>
+      <Subheader>Sinking transaction</Subheader>
       <Paragraph>
         The locking mechanism is contained within each transaction.
-        Stellarcarbon only offers transactions that retire the purchased{" "}
-        <CARBONCurrencyIcon className="inline" /> in exchange for CarbonSINK. As
-        such, the customer will receive CarbonSINK in their wallet (not the{" "}
-        <CARBONCurrencyIcon className="inline" /> itself) after the{" "}
-        <SCLink href="/explain/how-it-works/retirement">retirement</SCLink> is
-        completed. The CarbonSINK asset represents an equal amount of{" "}
-        <CARBONCurrencyIcon className="inline" /> sunk and cannot be traded.
+        Stellarcarbon builds transactions that swap the purchased{" "}
+        <CARBONCurrencyIcon className="inline" /> for CarbonSINK. As such, the 
+        recipient receives CarbonSINK in their wallet as proof of their contribution.
+        This creates an obligation for Stellarcarbon to process a{" "}
+        <SCLink href="/explain/how-it-works/retirement">retirement</SCLink> in the
+        Verra Registry. The CarbonSINK asset represents an equal amount of{" "}
+        <CARBONCurrencyIcon className="inline" /> sunk and cannot be traded or
+        transferred.
       </Paragraph>
 
       <Subheader>Key guarantees for blockchain experts</Subheader>
       <Paragraph>
         <ul className="list-disc mx-6 space-y-2">
           <li>
-            <b>Atomicity</b>: both token burn and mint occur in a single Ledger
+            <b>Atomicity</b>: both token burn and mint occur in a single ledger
             transaction.
           </li>
           <li>
-            <b>Transparency</b>: every sink is publicly visible on Stellar’s
-            block explorer and in our audit tool.
+            <b>Transparency</b>: every sinking transaction is publicly visible on 
+            Stellar block explorers and in our audit tool.
           </li>
           <li>
-            <b>Traceability</b>: on-chain events are correlated to off-chain
-            retirements via requestId.
+            <b>Traceability</b>: retirements link to the hash digests of the 
+            transactions that they incorporate.
           </li>
         </ul>
       </Paragraph>

src/app/explain/how-it-works/page.tsx

@@ -12,34 +12,50 @@ export default function ExplainIntegrationPage() {
       <Header>Stellarcarbon for business</Header>
       <Paragraph>
         Enable your product or platform to automatically channel value into
-        rainforest and ecosystem projects. Whether you run a web app, mobile
+        regenerative impact projects. Whether you run a web app, mobile
         dApp, or backend service on Stellar, you can integrate carbon-sinking
-        with just a few lines of code, so every transaction your users make also
-        contributes to nature.
+        with just a few lines of code. Let every transaction your users make also
+        contribute to nature.
       </Paragraph>
 
       <Subheader>HTTP API integration</Subheader>
       <Paragraph>
         Request a sinking transaction from our API and sign it with your company
-        wallet or let your customer sign it with theirs, you choose what fits
-        best. Post the signed transaction back to our API and you done.
+        wallet or let your customer sign it with theirs. You choose what fits
+        best. Use our official <SCLink
+          href="https://github.com/stellarcarbon/sc-sdk-typescript"
+          target="_blank"
+        >
+          Typescript SDK
+        </SCLink>, or generate your own from the <SCLink
+          href="https://api.stellarcarbon.io/docs"
+          target="_blank"
+        >
+          OpenAPI Specification
+        </SCLink>.
       </Paragraph>
 
-      <Subheader>Soroban Smart-Contract integration</Subheader>
+      <Subheader>Soroban smart contract integration</Subheader>
       <Paragraph>
-        If you use smart contracts in your workflow, you can easily add a single
-        line to sink CARBON:
+        If you use smart contracts in your workflow, it takes just a couple of
+        lines to sink CARBON:
         <Codeblock>
-          {`contract.call("sink", (user_address, contribution_amount))?;`}
+{`let sink_client = sink_contract::Client::new(&env, &sink_contract_id);
+sink_client.sink_carbon(funder, recipient, amount, project_id, memo_text);`}
         </Codeblock>
+        Read more about our open-source components on the <SCLink
+          href="/software"
+        >
+          software page
+        </SCLink>.
       </Paragraph>
 
       <Subheader>Contact us</Subheader>
       <Paragraph>
-        We are eager to help you integrate Stellarcarbon into your Stellar
+        We are happy to offer support while you integrate Stellarcarbon into your
         workflows. Just send us an email at{" "}
-        <SCLink href={"mailto:info@stellarcarbon.io"}>
-          info@stellarcarbon.io
+        <SCLink href={"mailto:admin@stellarcarbon.io"}>
+          admin@stellarcarbon.io
         </SCLink>
         .
       </Paragraph>

src/app/explain/how-it-works/retirement/page.tsx

@@ -27,7 +27,7 @@ export default function ExplainIntroductionPage() {
         </SCLink>{" "}
         to make sure the corresponding Verified Carbon Units (VCU) are retired
         on the Verra Registry in a transparent way. This makes it very easy for
-        Stellar users to compensate for their CO2 emissions or contribute to
+        Stellar users to compensate for their CO₂ emissions or contribute to
         nature conservation projects.
       </Paragraph>
       <Paragraph>
@@ -36,15 +36,9 @@ export default function ExplainIntroductionPage() {
         keep exploring!
       </Paragraph>
 
-      {/* <Paragraph>
-        Otherwise, have a look around on this explain page where we try be as
-        transparent as possible about the accounting mechanisms behind
-        Stellarcarbon.
-      </Paragraph> */}
-
       <Subheader>Why rainforest conservation matters</Subheader>
       <Paragraph>
-        Rainforests cover just 2 % of land yet hold 25 % of its land-based
+        Rainforests cover just 2% of land yet hold 25% of the land-based
         carbon and shelter over half of all land species. If the forests in
         Ucayali & Huánuco were to be removed it would be disastrous from an
         ecological viewpoint. Without protection, developers could clear them