Clarity Values Guide

[reedrosenbluth]

A guide for dealing with Clarity values in JS.

#816

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/blockstack/blockstack-docs/mp70yhxmt
✅ Preview: https://blockstack-docs-git-clarity-values-guide.blockstack.vercel.app

[github-actions]

Blockstack Documentation

Blockstack docs have been deployed with Vercel using the code from this PR!

• Blockstack Docs

📝 Changed routes:

…s/clarity-values-guide
(view full size)

Built with commit 8a8901e.

[yknl]

I think it would be really helpful to document the reverse of constructing Clarity values. For example, if I receive a responseCV from a contract function call. How do I extract the value and how do I work with them in JavaScript?

[njordhov]

This type corresponds to the ECMAScript Record, an immutable mapping from keys to values. The tuple type in Clarity is a misnomer, likely to confuse JS devs as TC39 will also introduce a Tuple type in ECMAScript that is more like an immutable array, notably different from the tuple in Clarity. Consider to clarify that this type is like a record.

[yknl]

LGTM, the additional explanation on utilizing Clarity objects in javascript is helpful.