DocuSign Integration
How completed DocuSign envelopes are attested on Canton: what is recorded, what stays private, how to connect an account, and the privacy trade-off.
When a DocuSign envelope completes, Memora can attest the signed documents on the Canton Network automatically. The result is a tamper-evident record that the executed agreement existed in exactly this form at that moment, distinguishable from manual uploads by a DocuSign provenance badge.
Privacy trade-off
Manual uploads in the attestation app are end-to-end encrypted: your browser hashes and encrypts the document and we never see the plaintext. Automated DocuSign ingestion cannot work that way, because there is no browser in the loop. To hash a completed envelope, our service must fetch the signed document from DocuSign and compute the hash server-side, so the plaintext passes through our infrastructure at the moment of ingestion.
For that reason DocuSign auto-attestation is an explicit, per-customer opt-in, and documents that arrive this way are labeled so you can tell them apart. If your requirement is that we never handle plaintext, download the completed envelope and upload it manually. The attestation is identical, and you can still record the DocuSign provenance as metadata. See Privacy and Encryption.
What happens when an envelope completes
- DocuSign sends a Connect event to us when an envelope reaches the completed state.
- Our service fetches the envelope's documents from DocuSign.
- The service hashes each document with SHA-256 and attests it on the Canton Network: a metadata contract records the hash and the originating party, and a signed-document contract records the signing parties you have mapped.
- The document appears in your workspace with a gold DocuSign badge on its thumbnail and
DocuSignin its Source column.
The service records the DocuSign envelope ID and signer details separately from the storage record, so parties that store the document do not see who signed it or which envelope it came from. Visibility of signer information follows the same selective-disclosure rules as other metadata.
What is recorded
| Recorded | Where | Visible to |
|---|---|---|
| SHA-256 hash of each signed document | On Canton | Parties you disclose to |
| Originating party | On Canton | Parties you disclose to |
| Signing parties | On Canton, in a separate contract | The signers and parties you disclose to |
| Source: DocuSign | Document metadata | Your workspace |
| DocuSign envelope ID | Document metadata | Your workspace and parties you disclose to; not visible to storage parties |
| The document content | Encrypted, off-chain | Your workspace and anyone you share with |
Connect a DocuSign account
An administrator sets this up once per DocuSign account.
- In your Memora workspace, open Settings and enable DocuSign attestation. Confirm the privacy trade-off above.
- In DocuSign, open Settings, Connect and create a new Connect configuration.
- Set the URL to publish to: Coming soon.
- Under trigger events, select Envelope Completed. The service ignores other events.
- Include document PDFs in the event payload if your DocuSign plan offers the option. Otherwise our service fetches them.
- Save, then send a test envelope and complete it. Within a few minutes the document appears in your workspace with the DocuSign badge.
Whether we use your DocuSign API credentials or our own integration key: Coming soon.
Map signers to Canton parties
The service records signing parties on Canton as party IDs. In your workspace settings, map the DocuSign signer identities you use, by email, to the Canton party that should be recorded as the signer. Unmapped signers are recorded under your workspace's own party.
Verify a DocuSign attestation
Open the document in the app and choose Verify, then select the completed PDF you downloaded from DocuSign. The hashes match if the file is byte for byte the one attested. DocuSign can generate a PDF with a certificate of completion appended. Verify against the same form of the document that was ingested.
Troubleshooting
| Symptom | Likely cause | What to do |
|---|---|---|
| Envelope completed but nothing appears | The Connect configuration is not publishing, or the trigger event is not Envelope Completed | Check the Connect log in DocuSign for the delivery attempt and its response |
| Document appears without the DocuSign badge | It was uploaded manually | Only automated ingestion sets the DocuSign source |
| Verify reports a mismatch | You selected a different rendering of the PDF | Download the completed document without the certificate of completion and verify again |
| Signer shows as your workspace party | The signer's email is not mapped | Add the mapping; existing attestations are not changed |
Disconnecting
Delete the Connect configuration in DocuSign, or disable DocuSign attestation in your Memora workspace. Documents already attested are unaffected.