Solana University Certification Dashboard
\n \n \n\n
\n {invalidInputs.length > 0 && Create Certificate Program
\n \nGet Certificate Programs
\n \nRegister Student
\n \nGrant Certificate
\n \nView Student Certificate
\n \n\n
\n );\n}\n\nfunction ValidationError({ invalidInputs }: { invalidInputs: string[] }) {\n return (\n \n {output}\n \n \n
\n );\n}\n"
},
{
"path": "build-a-university-certification-nft/client/src/index.css",
"content": ":root {\n font-family: Inter, system-ui, Avenir, Helvetica, Arial, sans-serif;\n line-height: 1.5;\n font-weight: 400;\n\n color-scheme: light dark;\n color: rgba(255, 255, 255, 0.87);\n background-color: #000000;\n\n font-synthesis: none;\n text-rendering: optimizeLegibility;\n -webkit-font-smoothing: antialiased;\n -moz-osx-font-smoothing: grayscale;\n -webkit-text-size-adjust: 100%;\n\n --solana-purple: #9945ff;\n --solana-green: #14f195;\n}\n\na {\n font-weight: 500;\n color: #646cff;\n text-decoration: inherit;\n}\na:hover {\n color: #535bf2;\n}\n\nbody {\n margin: 0;\n display: flex;\n place-items: center;\n min-width: 320px;\n min-height: 100vh;\n}\n\nh1 {\n font-size: 1.8em;\n line-height: 1.1;\n background: -webkit-linear-gradient(\n 120deg,\n var(--solana-green),\n var(--solana-purple)\n );\n -webkit-background-clip: text;\n background-clip: text;\n -webkit-text-fill-color: transparent;\n}\n\n.controls {\n display: flex;\n flex-direction: row;\n gap: 1em;\n padding: 1em;\n border-radius: 8px;\n background-color: rgba(40, 40, 40, 0.5);\n backdrop-filter: blur(8px);\n box-shadow: 0 0 0 1px rgba(0, 0, 0, 0.1);\n}\n\nbutton {\n border-radius: 8px;\n border: 1px solid transparent;\n padding: 0.6em 1.2em;\n font-size: 1em;\n font-weight: 500;\n font-family: inherit;\n background-color: var(--solana-purple);\n cursor: pointer;\n transition: border-color 0.25s;\n}\nbutton:hover {\n border-color: #646cff;\n}\nbutton:focus,\nbutton:focus-visible {\n outline: 4px auto -webkit-focus-ring-color;\n}\n\n@media (prefers-color-scheme: light) {\n :root {\n color: #213547;\n background-color: #ffffff;\n }\n a:hover {\n color: #747bff;\n }\n button {\n background-color: #f9f9f9;\n }\n}\n"
},
{
"path": "build-a-university-certification-nft/client/src/main.tsx",
"content": "import React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport { App } from './app';\nimport './index.css';\n\nReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(\n Form requires: {invalidInputs.join(', ')}
\n\n
\n\n```rust\nleaderboard: Account<'info, Leaderboard>,\ngame_owner: Signer<'info>,\nsystem_program: Program<'info, System>,\n```\n\n
\n\nInitializeLeaderboard
\n\n```rust\nleaderboard: Account<'info, Leaderboard>,\ngame_owner: Signer<'info>,\nsystem_program: Program<'info, System>,\n```\n\n\n
\n\n```rust\nuser: Signer<'info>,\ngame_owner: AccountInfo<'info>,\nleaderboard: Account<'info, Leaderboard>,\nsystem_program: Program<'info, System>,\n```\n\n
\n\nNewGame
\n\n```rust\nuser: Signer<'info>,\ngame_owner: AccountInfo<'info>,\nleaderboard: Account<'info, Leaderboard>,\nsystem_program: Program<'info, System>,\n```\n\n\n
\n\n```rust\nleaderboard: Account<'info, Leaderboard>,\nuser: Signer<'info>,\n```\n\n
\n\nAddPlayerToLeaderboard
\n\n```rust\nleaderboard: Account<'info, Leaderboard>,\nuser: Signer<'info>,\n```\n\n\n
\n\n```rust\nplayers: Vec\n```\n\n
\n\nLeaderboard
\n\n```rust\nplayers: Vec\n
\n\n```rust\nusername: String, // max length 32\npubkey: Pubkey,\nscore: u64,\nhas_payed: bool,\n```\n\n
\n\n### Notes\n\n- You should not add any external dependencies to the `package.json` file for the tests\n - You have access to `chai`\n- Many tests rely on previous user stories being correctly implemented\n\n[^1]: Hint: You can use the `transfer` function from the `system_instruction` module in the `solana_program` crate.\n\n### --tests--\n\nYou should generate a new keypair and store it in a file called `game-owner.json`.\n\n```js\ntry {\n const fileExists = await __fsp.access(\n __path.join(__projectDir, './game-owner.json'),\n __fsp.constants.F_OK\n );\n} catch (e) {\n assert.fail(e);\n}\n```\n\nYou should add the correct program id to the `programs.localnet.rock_destroyer` key in the `Anchor.toml` file.\n\n```js\nconst anchorToml = await __fsp.readFile(\n __path.join(__projectDir, 'Anchor.toml'),\n 'utf-8'\n);\nconst actualProgramId = anchorToml.match(/rock_destroyer = \"(.*)\"/)?.[1];\nconst { stdout } = await __helpers.getCommandOutput(\n 'anchor keys list',\n __projectDir\n);\nconst expectedProgramId = stdout.match(/rock_destroyer: (.*)/)?.[1];\nassert.equal(actualProgramId, expectedProgramId);\n```\n\nYou should add the correct program id to the `declare_id!` call in the `lib.rs` file.\n\n```js\nconst librs = await __fsp.readFile(\n __path.join(__projectDir, 'programs/rock-destroyer/src/lib.rs'),\n 'utf-8'\n);\nconst actualProgramId = librs.match(/declare_id\\!\\((.*)\\)/)?.[1];\nconst { stdout } = await __helpers.getCommandOutput(\n 'anchor keys list',\n __projectDir\n);\nconst expectedProgramId = stdout.match(/rock_destroyer: (.*)/)?.[1];\nassert.equal(actualProgramId.replaceAll(/['\"`]/g), expectedProgramId);\n```\n\nThe `rock_destroyer` program should expose an `initialize_leaderboard` instruction handler.\n\n```js\nconst testDir = await __createTestDir(4);\nawait __buildTestDir(4);\nconst { RockDestroyer } = await __helpers.importSansCache(\n __path.join(testDir, 'target/types/rock_destroyer')\n);\nconst ixs = RockDestroyer.instructions;\nconst initializeLeaderboardIx = ixs.find(\n ix => ix.name === 'initializeLeaderboard'\n);\nassert.exists(\n initializeLeaderboardIx,\n 'The `RockDestroyer` object in `target/types/rock_destroyer` should have an `instructions[].name` property equal to `initializeLeaderboard`'\n);\n```\n\nThe `initialize_leaderboard` instruction handler should take a context generic over an `InitializeLeaderboard` accounts struct.\n\n```js\nconst testDir = await __createTestDir(5);\nawait __buildTestDir(5);\nconst { RockDestroyer } = await __helpers.importSansCache(\n __path.join(testDir, 'target/types/rock_destroyer')\n);\nconst ixs = RockDestroyer.instructions;\nconst initializeLeaderboardIx = ixs.find(\n ix => ix.name === 'initializeLeaderboard'\n);\nconst accounts = initializeLeaderboardIx.accounts;\nassert.deepInclude(accounts, {\n name: 'leaderboard',\n isMut: true,\n isSigner: false\n});\nassert.deepInclude(accounts, {\n name: 'gameOwner',\n isMut: true,\n isSigner: true\n});\nassert.deepInclude(accounts, {\n name: 'systemProgram',\n isMut: false,\n isSigner: false\n});\n```\n\nThe `rock_destroyer` program should expose a `new_game` instruction handler.\n\n```js\nconst testDir = await __createTestDir(4);\nawait __buildTestDir(4);\nconst { RockDestroyer } = await __helpers.importSansCache(\n __path.join(testDir, 'target/types/rock_destroyer')\n);\nconst ixs = RockDestroyer.instructions;\nconst newGameIx = ixs.find(ix => ix.name === 'newGame');\nassert.exists(\n newGameIx,\n 'The `RockDestroyer` object in `target/types/rock_destroyer` should have an `instructions[].name` property equal to `newGame`'\n);\n```\n\nThe `new_game` instruction handler should take a context generic over a `NewGame` accounts struct.\n\n```js\nconst testDir = await __createTestDir(6);\nawait __buildTestDir(6);\nconst { RockDestroyer } = await __helpers.importSansCache(\n __path.join(testDir, 'target/types/rock_destroyer')\n);\nconst ixs = RockDestroyer.instructions;\nconst newGameIx = ixs.find(ix => ix.name === 'newGame');\nconst accounts = newGameIx.accounts;\nassert.deepInclude(accounts, {\n name: 'user',\n isMut: true,\n isSigner: true\n});\nassert.deepInclude(accounts, {\n name: 'leaderboard',\n isMut: true,\n isSigner: false\n});\nassert.deepInclude(accounts, {\n name: 'gameOwner',\n isMut: true,\n isSigner: false\n});\nassert.deepInclude(accounts, {\n name: 'systemProgram',\n isMut: false,\n isSigner: false\n});\n```\n\nThe `rock_destroyer` program should expose an `add_player_to_leaderboard` instruction handler.\n\n```js\nconst testDir = await __createTestDir(4);\nawait __buildTestDir(4);\nconst { RockDestroyer } = await __helpers.importSansCache(\n __path.join(testDir, 'target/types/rock_destroyer')\n);\nconst ixs = RockDestroyer.instructions;\nconst initializeLeaderboardIx = ixs.find(\n ix => ix.name === 'addPlayerToLeaderboard'\n);\nassert.exists(\n initializeLeaderboardIx,\n 'The `RockDestroyer` object in `target/types/rock_destroyer` should have an `instructions[].name` property equal to `addPlayerToLeaderboard`'\n);\n```\n\nThe `add_player_to_leaderboard` instruction handler should take a context generic over an `AddPlayerToLeaderboard` accounts struct.\n\n```js\nconst testDir = await __createTestDir(7);\nawait __buildTestDir(7);\nconst { RockDestroyer } = await __helpers.importSansCache(\n __path.join(testDir, 'target/types/rock_destroyer')\n);\nconst ixs = RockDestroyer.instructions;\nconst ix = ixs.find(ix => ix.name === 'addPlayerToLeaderboard');\nconst accounts = ix.accounts;\nassert.deepInclude(accounts, {\n name: 'leaderboard',\n isMut: true,\n isSigner: false\n});\nassert.deepInclude(accounts, {\n name: 'user',\n isMut: true,\n isSigner: true\n});\n```\n\nThere should be an `it` block named `\"initializes leaderboard\"`.\n\n```js\nconst callExpressions = babelisedCode\n .getType('CallExpression')\n .filter(c => {\n return;\n c.callee?.name === 'it';\n })\n .map(c => c.arguments?.[1]?.value);\nassert.include(callExpressions, 'initializes leaderboard');\n```\n\nThere should be an `it` block named `\"creates a new game\"`.\n\n```js\nconst callExpressions = babelisedCode\n .getType('CallExpression')\n .filter(c => {\n return;\n c.callee?.name === 'it';\n })\n .map(c => c.arguments?.[1]?.value);\nassert.include(callExpressions, 'creates a new game');\n```\n\nThere should be an `it` block named `\"adds a player to the leaderboard\"`.\n\n```js\nconst callExpressions = babelisedCode\n .getType('CallExpression')\n .filter(c => {\n return;\n c.callee?.name === 'it';\n })\n .map(c => c.arguments?.[1]?.value);\nassert.include(callExpressions, 'adds a player to the leaderboard');\n```\n\nThere should be an `it` block named `\"throws an error when the user has not payed\"`.\n\n```js\nconst callExpressions = babelisedCode\n .getType('CallExpression')\n .filter(c => {\n return;\n c.callee?.name === 'it';\n })\n .map(c => c.arguments?.[1]?.value);\nassert.include(callExpressions, 'throws an error when the user has not payed');\n```\n\n### --before-all--\n\n```js\nconst __fsp = await import('fs/promises');\nconst __path = await import('path');\nconst __projectDir = 'build-an-anchor-leaderboard/_answer/rock-destroyer';\nconst __testDir = 'build-an-anchor-leaderboard/__test/rock-destroyer';\nconst codeString = await __helpers.getFile(\n './' + join(__projectDir, 'tests/index.ts')\n);\nconst babelisedCode = new __helpers.Babeliser(codeString, {\n plugins: ['typescript']\n});\n\nasync function __createTestDir(num) {\n const testDir = `${__testDir}-${num}`;\n // Remove old test dir\n logover.debug('Removing old test dir');\n await __fsp.rm(testDir, { recursive: true, force: true });\n // Create new test dir\n logover.debug('Creating new test dir');\n await __fsp.cp(__projectDir, testDir, { recursive: true });\n return testDir;\n}\n\nasync function __buildTestDir(num) {\n const { stdout, stderr } = await __helpers.getCommandOutput(\n 'anchor build',\n `${__testDir}-${num}`\n );\n if (stderr) {\n throw new Error(stderr);\n }\n return stdout;\n}\n\nglobal.__projectDir = __projectDir;\nglobal.__testDir = __testDir;\nglobal.__fsp = __fsp;\nglobal.__path = __path;\nglobal.__buildTestDir = __buildTestDir;\nglobal.__createTestDir = __createTestDir;\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.__projectDir;\ndelete global.__testDir;\ndelete global.__fsp;\ndelete global.__path;\ndelete global.babelisedCode;\n\ndelete global.__buildTestDir;\ndelete global.__createTestDir;\n```\n\n## --fcc-end--\n"
},
{
"path": "curriculum/locales/english/build-and-deploy-your-freeform-app.md",
"content": "# Solana - Build and Deploy Your Freeform App\n\n## 1\n\n### --description--\n\nCongratulations on making it to the final project for this course! 🚀 🧨 🌟\n\nYou have learnt a lot about the Solana ecosystem, and how to build on it. Now, it is time for you to test your skills and build an app of your own. Once you are done, feel free to share a link to it on Twitter, and `@freeCodeCamp`.\n\nYou can use whatever tools you want to build your app, and you are encouraged to explore the library ecosystem to find the best tools for the job.\n\n- You can use Player
\n\n```rust\nusername: String, // max length 32\npubkey: Pubkey,\nscore: u64,\nhas_payed: bool,\n```\n\n\n\n| Decimals | Smallest Token Unit |\n| :------: | :-----------------: |\n| 0 | 1 |\n| 1 | 0.1 |\n| ... | ... |\n| 9 | 0.000000001 |\n\n
\n\n### --tests--\n\nYou should import `createMint` from `@solana/spl-token`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@solana/spl-token';\n});\nassert.exists(\n importDeclaration,\n 'An import from `@solana/spl-token` should exist'\n);\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'createMint',\n '`createMint` should be imported from `@solana/spl-token`'\n);\n```\n\nYou should have `const mint = await createMint(connection, payer, mintAuthority, freezeAuthority, 9);` in `create-mint-account.js`.\n\n```js\nconst mintDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'mint';\n});\nassert.exists(mintDeclaration, 'A variable named `mint` should exist');\nconst mintAwaitExpression = mintDeclaration.declarations?.[0]?.init;\nassert.equal(\n mintAwaitExpression.type,\n 'AwaitExpression',\n 'The `createMint` call should be awaited'\n);\nconst createMintCallExpression = mintAwaitExpression.argument;\nassert.equal(\n createMintCallExpression.callee.name,\n 'createMint',\n 'The `mint` variable should be initialised with the `createMint` function'\n);\nconst createMintArguments = createMintCallExpression.arguments;\nassert.equal(\n createMintArguments.length,\n 5,\n 'The `createMint` function should be called with 5 arguments'\n);\nconst [\n connectionArgument,\n payerArgument,\n mintAuthorityArgument,\n freezeAuthorityArgument,\n decimalsArgument\n] = createMintArguments;\nassert.equal(\n connectionArgument.name,\n 'connection',\n 'The first argument to `createMint` should be `connection`'\n);\nassert.equal(\n payerArgument.name,\n 'payer',\n 'The second argument to `createMint` should be `payer`'\n);\nassert.equal(\n mintAuthorityArgument.name,\n 'mintAuthority',\n 'The third argument to `createMint` should be `mintAuthority`'\n);\nassert.equal(\n freezeAuthorityArgument.name,\n 'freezeAuthority',\n 'The fourth argument to `createMint` should be `freezeAuthority`'\n);\nassert.equal(\n decimalsArgument.value,\n 9,\n 'The fifth argument to `createMint` should be `9`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-solanas-token-program-by-minting-a-fungible-token/create-mint-account.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n### --seed--\n\n#### --\"create-mint-account.js\"--\n\n```js\nimport { Connection } from '@solana/web3.js';\nimport { payer } from './utils.js';\n\nconst connection = new Connection('http://localhost:8899');\n\nconst mintAuthority = payer.publicKey;\nconst freezeAuthority = payer.publicKey;\n```\n\n## 10\n\n### --description--\n\nThe `createMint` function returns the public key of the newly-created Mint Account.\n\nLog the base-58 representation of `mint` to the console.\n\n### --tests--\n\nYou should use the `toBase58` method on `mint`.\n\n```js\nconst mintMemberExpression = babelisedCode\n .getType('MemberExpression')\n .find(m => {\n return m.object?.name === 'mint' && m.property?.name === 'toBase58';\n });\nassert.exists(\n mintMemberExpression,\n 'The `mint` variable should have a `toBase58` method called on it'\n);\n```\n\nYou can have `console.log(mint.toBase58());` in `create-mint-account.js`.\n\n```js\nconst consoleLogCallExpression = babelisedCode\n .getType('CallExpression')\n .find(c => {\n return (\n c.callee?.object?.name === 'console' && c.callee?.property?.name === 'log'\n );\n });\nassert.exists(consoleLogCallExpression, 'A `console.log` call should exist');\nconst consoleLogArguments = consoleLogCallExpression.arguments;\n// Assert one of the arguments is the `mint.toBase58()` call\nconst mintToBase58CallExpression = consoleLogArguments.find(a => {\n return (\n a.type === 'CallExpression' &&\n a.callee.object.name === 'mint' &&\n a.callee.property.name === 'toBase58'\n );\n});\nassert.exists(\n mintToBase58CallExpression,\n 'One of the arguments to `console.log` should be `mint.toBase58()`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-solanas-token-program-by-minting-a-fungible-token/create-mint-account.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n### --seed--\n\n#### --\"create-mint-account.js\"--\n\n```js\nimport { Connection } from '@solana/web3.js';\nimport { payer } from './utils.js';\nimport { createMint } from '@solana/spl-token';\n\nconst connection = new Connection('http://localhost:8899');\n\nconst mintAuthority = payer.publicKey;\nconst freezeAuthority = payer.publicKey;\n\nconst mint = await createMint(\n connection,\n payer,\n mintAuthority,\n freezeAuthority,\n 9\n);\n```\n\n## 11\n\n### --description--\n\nStart a local Solana cluster. Ensure the RPC URL is set to `http://localhost:8899`.\n\n### --tests--\n\nYour Solana config RPC URL should be set to `http://localhost:8899`.\n\n```js\nconst command = `solana config get json_rpc_url`;\nawait new Promise(res => setTimeout(() => res(), 2000));\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\nassert.include(\n stdout,\n 'http://localhost:8899',\n 'Try running `solana config set --url localhost`'\n);\n```\n\nYou should run `solana-test-validator` in a separate terminal.\n\n```js\nawait new Promise(res => setTimeout(() => res(), 2000));\nconst command = `curl http://localhost:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n### --seed--\n\n#### --\"create-mint-account.js\"--\n\n```js\nimport { Connection } from '@solana/web3.js';\nimport { payer } from './utils.js';\nimport { createMint } from '@solana/spl-token';\n\nconst connection = new Connection('http://localhost:8899');\n\nconst mintAuthority = payer.publicKey;\nconst freezeAuthority = payer.publicKey;\n\nconst mint = await createMint(\n connection,\n payer,\n mintAuthority,\n freezeAuthority,\n 9\n);\n\nconsole.log('Token Unique Identifier:', mint.toBase58());\n```\n\n## 12\n\n### --description--\n\nAirdrop some SOL to the payer account to pay for the transaction fees:\n\n```bash\nsolana airdrop \n
\n\n### --tests--\n\nYou should run `node create-mint-account.js` in a terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.include(\n lastCommand,\n 'node create-mint-account.js',\n 'You should run `node create-mint-account.js` in a terminal'\n);\n```\n\nThe output of `node create-mint-account.js` should include the base-58 representation of the Mint Account.\n\n```js\nconst terminalOutput = await __helpers.getTerminalOutput();\nassert.match(terminalOutput, /[A-z0-9]{44}/);\n```\n\nThe validator should be running at `http://localhost:8899`.\n\n```js\nconst command = `curl http://localhost:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 14\n\n### --description--\n\nThe output should include the base-58 representation of the Mint Account. In other words, the mint account's public key address.\n\nCopy this address, and paste it into the `MINT_ADDRESS_58` variable in `utils.js`. Then, uncomment the `mintAddress` export statement.\n\n### --tests--\n\nYou should have `const MINT_ADDRESS_58 = '...';` in `utils.js`.\n\n```js\n// TODO: Note that seed cannot add this...\nconst variableDeclaration = babelisedCode\n .getVariableDeclarations()\n .find(v => v.declarations?.[0]?.id?.name === 'MINT_ADDRESS_58');\nassert.exists(\n variableDeclaration,\n 'The `MINT_ADDRESS_58` variable is should exist'\n);\nconst value = variableDeclaration.declarations?.[0]?.init?.value;\nassert.isString(value, 'The `MINT_ADDRESS_58` value should be a string');\nassert.isNotEmpty(value, 'The `MINT_ADDRESS_58` value should not be empty');\n```\n\nYou should uncomment `export const mintAddress = new PublicKey(MINT_ADDRESS_58);` in `utils.js`.\n\n```js\nconst exportStatement = babelisedCode\n .getType('ExportNamedDeclaration')\n .find(e => e.declaration?.declarations?.[0]?.id?.name === 'mintAddress');\nassert.exists(\n exportStatement,\n 'The `mintAddress` export statement should be UNCOMMENTED'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-solanas-token-program-by-minting-a-fungible-token/utils.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString, {\n plugins: ['importAssertions']\n});\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 15\n\n### --description--\n\nNow that you have created a _Mint Account_, you need to create a _Token Account_.\n\nA _Token Account_ is owned by another account, and holds tokens of a specific mint.\n\nCreate a new file named `create-token-account.js`.\n\n### --tests--\n\nYou can use `touch` to create a file named `create-token-account.js`.\n\n```js\nconst fileExists = await __helpers.fileExists(\n 'learn-solanas-token-program-by-minting-a-fungible-token/create-token-account.js'\n);\nassert.isTrue(fileExists);\n```\n\n## 16\n\n### --description--\n\nWithin `create-token-account.js`, declare a variable `connection`, and assign it a new instance of the `Connection` class. Pass in your local Solana RPC URL as the first argument.\n\n### --tests--\n\nYou should have `const connection = new Connection('http://localhost:8899');` in `create-token-account.js`.\n\n```js\nconst connectionVariableDeclaration = babelisedCode\n .getVariableDeclarations()\n .find(v => v.declarations?.[0]?.id?.name === 'connection');\nassert.exists(\n connectionVariableDeclaration,\n 'A `connection` variable should be declared'\n);\nconst newExpression = connectionVariableDeclaration.declarations[0].init;\nassert.equal(\n newExpression.callee?.name,\n 'Connection',\n '`connection` should be initialised with a new `Connection`'\n);\nassert.equal(\n newExpression.arguments?.[0]?.value,\n 'http://localhost:8899',\n \"A new connection should be created with `new Connection('http://localhost:8899')`\"\n);\n```\n\nYou should import `Connection` from `@solana/web3.js`.\n\n```js\nconst solanaWeb3ImportDeclaration = babelisedCode\n .getImportDeclarations()\n .find(i => {\n return i.source.value === '@solana/web3.js';\n });\nassert.exists(\n solanaWeb3ImportDeclaration,\n 'An import from `@solana/web3.js` should exist'\n);\nconst connectionImportSpecifier = solanaWeb3ImportDeclaration.specifiers.find(\n s => {\n return s.imported.name === 'Connection';\n }\n);\nassert.exists(\n connectionImportSpecifier,\n '`Connection` should be imported from `@solana/web3.js`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-solanas-token-program-by-minting-a-fungible-token/create-token-account.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n### --seed--\n\n#### --cmd--\n\n```bash\ntouch create-token-account.js\n```\n\n## 17\n\n### --description--\n\nWithin `create-token-account.js`, import `payer` and `mintAddress` from `utils.js`.\n\n### --tests--\n\nYou should import `payer` from `utils.js`.\n\n```js\nconst utilsImportDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === './utils.js';\n});\nassert.exists(\n utilsImportDeclaration,\n 'An import from `./utils.js` should exist'\n);\nconst payerImportSpecifiers = utilsImportDeclaration.specifiers.map(s => {\n return s.imported.name;\n});\nassert.include(\n payerImportSpecifiers,\n 'payer',\n '`payer` should be imported from `./utils.js`'\n);\n```\n\nYou should import `mintAddress` from `utils.js`.\n\n```js\nconst utilsImportDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === './utils.js';\n});\nassert.exists(\n utilsImportDeclaration,\n 'An import from `./utils.js` should exist'\n);\nconst mintAddressImportSpecifiers = utilsImportDeclaration.specifiers.map(s => {\n return s.imported.name;\n});\nassert.include(\n mintAddressImportSpecifiers,\n 'mintAddress',\n '`mintAddress` should be imported from `./utils.js`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-solanas-token-program-by-minting-a-fungible-token/create-token-account.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n### --seed--\n\n#### --\"create-token-account.js\"--\n\n```js\nimport { Connection } from '@solana/web3.js';\n\nconst connection = new Connection('http://localhost:8899');\n```\n\n## 18\n\n### --description--\n\nImport the `getOrCreateAssociatedTokenAccount` function from `@solana/spl-token`, to retrieve an associated token account, or create it if it does not exist:\n\n```typescript\ngetOrCreateAssociatedTokenAccount(\n connection: Connection,\n payer: Signer, // Payer for this transaction\n mint: PublicKey, // Address of the associated token mint\n owner: PublicKey // Address of the account to own the token account\n): PromiseNOTE: Error
\n\nIf this command fails with the below error, wait a few seconds and run it again - transactions (e.g. Airdrops) take a few seconds to be finalised.\n\n```bash\n/workspace/solana-curriculum/learn-solanas-token-program-by-minting-a-fungible-token/node_modules/@solana/web3.js/lib/index.cjs.js:9754\n throw new SendTransactionError('failed to send transaction: ' + res.error.message, logs);\n ^\n\nSendTransactionError: failed to send transaction: Transaction simulation failed: Attempt to debit an account but found no record of a prior credit.\n```\n\n\n
\n\n### --tests--\n\nYou should run `node spl-program/create-mint-account.js` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node spl-program/create-mint-account.js',\n 'Try running `node spl-program/create-mint-account.js` in the terminal'\n);\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 9\n\n### --description--\n\nRemember to airdrop some SOL to the wallet 🤦♂️\n\n### --tests--\n\nThe `wallet.json` account should have at least 2 SOL.\n\n```js\nconst { stdout } = await __helpers.getCommandOutput(\n `solana balance ./learn-the-metaplex-sdk-by-minting-an-nft/wallet.json`\n);\nconst balance = stdout.trim()?.match(/\\d+/)?.[0];\nassert.isAtLeast(\n parseInt(balance),\n 2,\n 'Try running `solana airdrop 2 ./wallet.json`'\n);\n```\n\nThe validator should be running at `http://localhost:8899`.\n\n```js\nconst command = `curl http://localhost:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 10\n\n### --description--\n\nYou can now mint an NFT!\n\nRun the following to create the mint account:\n\n```bash\nnode spl-program/create-mint-account.js\n```\n\n### --tests--\n\nYou should run `node spl-program/create-mint-account.js` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node spl-program/create-mint-account.js',\n 'Try running `node spl-program/create-mint-account.js` in the terminal'\n);\n```\n\nThe command should succeed.\n\n```js\n// Test terminal-out includes value that can be parsed as a PublicKey.\nconst terminalOut = await __helpers.getTerminalOutput();\nconst base58String = terminalOut.match(/[\\w\\d]{32,44}/)?.[0];\nassert.exists(\n base58String,\n 'The terminal output should include a base58 string'\n);\ntry {\n console.log('TEST: ', terminalOut.match(/[\\w\\d]{32,44}/));\n const { PublicKey } = await import('@solana/web3.js');\n new PublicKey(base58String);\n} catch (e) {\n assert.fail(e);\n}\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 11\n\n### --description--\n\nPut the mint address in `env.MINT_ACCOUNT_ADDRESS` in the `package.json` file.\n\n### --tests--\n\nThe `package.json` file should have a `env.MINT_ACCOUNT_ADDRESS` property.\n\n```js\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson,\n 'env',\n 'The `package.json` file should have an `env` property.'\n);\nassert.property(\n packageJson.env,\n 'MINT_ACCOUNT_ADDRESS',\n 'The `package.json` file should have an `env.MINT_ACCOUNT_ADDRESS` property.'\n);\n```\n\nThe `env.MINT_ACCOUNT_ADDRESS` property should match an NFT owned by `wallet.json`.\n\n```js\nconst command =\n 'solana address -k learn-the-metaplex-sdk-by-minting-an-nft/wallet.json';\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\nconst walletAddress = stdout.trim();\n\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson,\n 'env',\n 'The `package.json` file should have an `env` property.'\n);\n\nassert.equal(\n packageJson.env.WALLET_ADDRESS,\n walletAddress,\n 'The `env.WALLET_ADDRESS` property should match the public key of `wallet.json`.'\n);\n\ntry {\n const { Connection } = await import('@solana/web3.js');\n const { TOKEN_PROGRAM_ID } = await import('@solana/spl-token');\n const connection = new Connection('http://127.0.0.1:8899');\n\n const mintAccounts = await connection.getParsedProgramAccounts(\n TOKEN_PROGRAM_ID,\n {\n filters: [\n {\n dataSize: 82\n },\n {\n memcmp: {\n offset: 4,\n bytes: packageJson.env.WALLET_ADDRESS\n }\n }\n ]\n }\n );\n\n const mintAccount = mintAccounts.find(\n ({ pubkey }) => pubkey?.toBase58() === packageJson.env.MINT_ACCOUNT_ADDRESS\n );\n assert.exists(\n mintAccount,\n 'The `env.MINT_ACCOUNT_ADDRESS` property should match an NFT owned by `wallet.json`.'\n );\n} catch (e) {\n assert.fail(e);\n}\n```\n\n## 12\n\n### --description--\n\nRun the following to create the token account:\n\n```bash\nnode spl-program/create-token-account.js\n```\n\n### --tests--\n\nYou should run `node spl-program/create-token-account.js` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node spl-program/create-token-account.js',\n 'Try running `node spl-program/create-token-account.js` in the terminal'\n);\n```\n\nThe command should succeed.\n\n```js\n// Test terminal-out includes value that can be parsed as a PublicKey.\nconst terminalOut = await __helpers.getTerminalOutput();\nconst base58String = terminalOut.match(/[\\w\\d]{32,44}/)?.[0];\nconst error = terminalOut.match('Error')?.[0];\nassert.notExists(error);\nassert.exists(\n base58String,\n 'The terminal output should include a base58 string'\n);\ntry {\n const { PublicKey } = await import('@solana/web3.js');\n new PublicKey(base58String);\n} catch (e) {\n assert.fail(e, 'Public key should be printed to the terminal');\n}\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 13\n\n### --description--\n\nPut the token account address in `env.TOKEN_ACCOUNT_ADDRESS` in the `package.json` file.\n\n### --tests--\n\nThe `package.json` file should have a `env` property.\n\n```js\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson,\n 'env',\n 'The `package.json` file should have an `env` property.'\n);\n```\n\nThe `package.json` file should have a `env.TOKEN_ACCOUNT_ADDRESS` property.\n\n```js\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson.env,\n 'TOKEN_ACCOUNT_ADDRESS',\n 'The `package.json` file should have an `env` property.'\n);\nassert.notEmpty(packageJson.env.TOKEN_ACCOUNT_ADDRESS);\n```\n\nThe `env.TOKEN_ACCOUNT_ADDRESS` property should match an NFT owned by `wallet.json`.\n\n```js\nconst command =\n 'solana address -k learn-the-metaplex-sdk-by-minting-an-nft/wallet.json';\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\nconst walletAddress = stdout.trim();\n\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson,\n 'env',\n 'The `package.json` file should have an `env` property.'\n);\n\nassert.equal(\n packageJson.env.WALLET_ADDRESS,\n walletAddress,\n 'The `env.WALLET_ADDRESS` property should match the public key of `wallet.json`.'\n);\n\ntry {\n const { Connection } = await import('@solana/web3.js');\n const { TOKEN_PROGRAM_ID } = await import('@solana/spl-token');\n const connection = new Connection('http://127.0.0.1:8899');\n\n const tokenAccounts = await connection.getParsedProgramAccounts(\n TOKEN_PROGRAM_ID,\n {\n filters: [\n {\n dataSize: 165\n },\n {\n memcmp: {\n offset: 32,\n bytes: packageJson.env.WALLET_ADDRESS\n }\n }\n ]\n }\n );\n\n const tokenAccount = tokenAccounts.find(\n ({ pubkey }) => pubkey.toBase58() === packageJson.env.TOKEN_ACCOUNT_ADDRESS\n );\n assert.exists(\n tokenAccount,\n 'The `env.TOKEN_ACCOUNT_ADDRESS` property should match an NFT owned by `wallet.json`.'\n );\n assert.equal(\n tokenAccount.account.data.parsed.info.mint,\n packageJson.env.MINT_ACCOUNT_ADDRESS,\n 'The `env.TOKEN_ACCOUNT_ADDRESS` should be associated with the `env.MINT_ACCOUNT_ADDRESS`.'\n );\n} catch (e) {\n assert.fail(e);\n}\n```\n\n## 14\n\n### --description--\n\nRun the following to mint the NFT to the token account:\n\n```bash\nnode spl-program/mint.js\n```\n\n### --tests--\n\nYou should run `node spl-program/mint.js` in the terminal.\n\n```js\n// Test command is run in correct directory\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node spl-program/mint.js',\n 'Try running `node spl-program/mint.js` in the terminal'\n);\n```\n\nThe command should succeed.\n\n```js\n// Test authority is null\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson,\n 'env',\n 'The `package.json` file should have an `env` property.'\n);\n\nassert.notEmpty(\n packageJson.env.MINT_ACCOUNT_ADDRESS,\n 'The `env.MINT_ACCOUNT_ADDRESS` property should be set.'\n);\n\ntry {\n const { Connection, PublicKey } = await import('@solana/web3.js');\n const { getMint } = await import('@solana/spl-token');\n const connection = new Connection('http://127.0.0.1:8899');\n\n const mint = await getMint(\n connection,\n new PublicKey(packageJson.env.MINT_ACCOUNT_ADDRESS)\n );\n assert.equal(mint.mintAuthority, null, 'The mint authority should be null.');\n} catch (e) {\n assert.fail(e);\n}\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 15\n\n### --description--\n\nRun the following to confirm the NFT has no mint authority, and has a total supply of 1:\n\n```bash\nnode spl-program/get-token-info.js\n```\n\n### --tests--\n\nYou should run `node spl-program/get-token-info.js` in the terminal.\n\n```js\n// Test command is run in correct directory\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node spl-program/get-token-info.js',\n 'Try running `node spl-program/get-token-info.js` in the terminal'\n);\n```\n\nThe command should succeed.\n\n```js\n// Script should be idempotent\nconst command = `node spl-program/get-token-info.js`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(\n command,\n 'learn-the-metaplex-sdk-by-minting-an-nft'\n);\nassert.include(stdout, 'mintAuthority: null');\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 16\n\n### --description--\n\nYou often hear about NFTs being odd pictures of a cat, but what if you wanted to associate more information with the NFT? For example, you could associate a name, description, and image with the NFT. This is where metadata comes in.\n\nThe metadata file is stored on IPFS, and the NFT is associated with the metadata file by storing the IPFS hash in the NFT's data field.\n\nThere are many accounts and files involved in the process of creating an NFT with metadata. Metaplex has a JavaScript SDK which provides common functionality for creating NFTs with metadata.\n\nInstall version `0.18.1` of `@metaplex-foundation/js`.\n\n### --tests--\n\nYou should install `@metaplex-foundation/js` version `0.18.1`.\n\n```js\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson.dependencies,\n '@metaplex-foundation/js',\n 'The `package.json` file should have a `@metaplex-foundation/js` dependency.'\n);\nassert.equal(\n packageJson.dependencies['@metaplex-foundation/js'],\n '0.18.1',\n 'Try running `npm install --save-exact @metaplex-foundation/js@0.18.1` in the terminal.'\n);\n```\n\n## 17\n\n### --description--\n\nCreate a file called `create-nft.js`.\n\n### --tests--\n\nYou should create a file called `create-nft.js`.\n\n```js\nconst fileExists = __helpers.fileExists(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nassert.isTrue(\n fileExists,\n 'The `learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js` file should exist.'\n);\n```\n\n## 18\n\n### --description--\n\nWithin `create-nft.js`, create a `connection` variable set to a new `Connection` of your local Solana validator.\n\n### --tests--\n\nYou should have `const connection = new Connection('http://127.0.0.1:8899');` in `create-nft.js`.\n\n```js\nconst connectionVariableDeclaration = babelisedCode\n .getVariableDeclarations()\n .find(v => v.declarations?.[0]?.id?.name === 'connection');\nassert.exists(\n connectionVariableDeclaration,\n 'You should declare a variable named `connection`'\n);\nconst newExpression = connectionVariableDeclaration.declarations[0].init;\nassert.equal(\n newExpression.callee.name,\n 'Connection',\n 'You should initialise `connection` with a new `Connection`'\n);\nassert.equal(\n newExpression.arguments[0].value,\n 'http://127.0.0.1:8899',\n \"You should create a new connection with `new Connection('http://127.0.0.1:8899')`\"\n);\n```\n\nYou should import `Connection` from `@solana/web3.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@solana/web3.js';\n});\nassert.exists(importDeclaration, 'You should import from `@solana/web3.js`');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'Connection',\n '`Connection` should be imported from `@solana/spl-token`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 19\n\n### --description--\n\nImport the `Metaplex` class from the Metaplex SDK, create a `metaplex` variable, and set it to:\n\n```js\nMetaplex.make();\n```\n\n### --tests--\n\nYou should have `const metaplex = Metaplex.make();` in `create-nft.js`.\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst variableDeclaration = babelisedCode\n .getVariableDeclarations()\n .find(v => v.declarations?.[0]?.id?.name === 'metaplex');\nassert.exists(\n variableDeclaration,\n 'You should declare a variable named `metaplex`'\n);\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(minifiedCode, /metaplex=Metaplex\\.make\\(\\)/);\n```\n\nYou should import `Metaplex` from `@metaplex-foundation/js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@metaplex-foundation/js';\n});\nassert.exists(\n importDeclaration,\n 'An import from `@metaplex-foundation/js` should exist'\n);\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'Metaplex',\n '`Metaplex` should be imported from `@metaplex-foundation/js`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 20\n\n### --description--\n\nThe `make` method on the `Metaplex` class expects a `Connection` that will be used to communicate with the cluster.\n\nPass the `connection` variable to the `make` method.\n\n### --tests--\n\nYou should have `const metaplex = Metaplex.make(connection);` in `create-nft.js`.\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'metaplex';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(minifiedCode, /metaplex=Metaplex\\.make\\(connection\\)/);\n```\n\n## 21\n\n### --description--\n\nThe `Metaplex` class has chainable `use` methods that allow you to configure the `Metaplex` instance with `MetaplexPlugin` implementations.\n\nConfigure the `Metaplex` instance to use the wallet keypair as the primary identity for transactions:\n\n```js\nMetaplex.make(connection).use(keypairIdentity(WALLET_KEYPAIR));\n```\n\nThe `keypairIdentity` function takes a `Keypair` and returns a `MetaplexPlugin`, and is exported from `@metaplex-foundation/js`.\n\nThe `WALLET_KEYPAIR` variable is a `Keypair` created from the `wallet.json` file, and is already exported from `utils.js`.\n\n### --tests--\n\nYou should have `const metaplex = Metaplex.make(connection).use(keypairIdentity(WALLET_KEYPAIR));` in `create-nft.js`.\n\n```js\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'metaplex';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /metaplex=Metaplex\\.make\\(connection\\)\\.use\\(keypairIdentity\\(WALLET_KEYPAIR\\)\\)/\n);\n```\n\nYou should import `keypairIdentity` from `@metaplex-foundation/js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@metaplex-foundation/js';\n});\nassert.exists(\n importDeclaration,\n 'An import from `@metaplex-foundation/js` should exist'\n);\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'keypairIdentity',\n '`keypairIdentity` should be imported from `@metaplex-foundation/js`'\n);\n```\n\nYou should import `WALLET_KEYPAIR` from `utils.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === './utils.js';\n});\nassert.exists(importDeclaration, 'An import from `./utils.js` should exist');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'WALLET_KEYPAIR',\n '`WALLET_KEYPAIR` should be imported from `./utils.js`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 22\n\n### --description--\n\nThe final configuration required is the _storage driver_ that will be used to store the NFT's metadata. This is because the NFT's metadata is not stored on-chain, but rather in a separate, often cheaper, storage system.\n\nSome common metadata storage locations are:\n\n- IPFS\n- Arweave\n- AWS\n\nFor the purpose of testing, and to avoid having to pay for storage, you can use the `localStorage` driver which will generate random URLs and keep track of their content in a local server.\n\nConfigure the `Metaplex` instance to use the `localStorage` driver.\n\n### --tests--\n\nYou should have `const metaplex = Metaplex.make(connection).use(keypairIdentity(WALLET_KEYPAIR)).use(localStorage());` in `create-nft.js`.\n\n```js\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'metaplex';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /metaplex=Metaplex\\.make\\(connection\\)\\.use\\(keypairIdentity\\(WALLET_KEYPAIR\\)\\)\\.use\\(localStorage\\(\\)\\)/\n);\n```\n\nYou should import `localStorage` from `utils.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === './utils.js';\n});\nassert.exists(importDeclaration, 'An import from `./utils.js` should exist');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'localStorage',\n '`localStorage` should be imported from `./utils.js`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 23\n\n### --description--\n\nThe storage driver takes an object with a `baseUrl` property, which is the base URL that will be used to generate the metadata URLs.\n\nSet the `baseUrl` to `http://127.0.0.1:3001/`.\n\n### --tests--\n\nYou should have `const metaplex = Metaplex.make(connection).use(keypairIdentity(WALLET_KEYPAIR)).use(localStorage({ baseUrl: 'http://127.0.0.1:3001/' }));` in `create-nft.js`.\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'metaplex';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /metaplex=Metaplex\\.make\\(connection\\)\\.use\\(keypairIdentity\\(WALLET_KEYPAIR\\)\\)\\.use\\(localStorage\\(\\{('|\"|`)?baseUrl\\1:('|\"|`)http:\\/\\/127\\.0\\.0\\.1:3001\\/\\2\\}\\)\\)/\n);\n```\n\n## 24\n\n### --description--\n\nYou can use any image you want for your NFT, but one is provided for you in the `assets` folder.\n\nDeclare a variable `imageBuffer`, and set it to the contents of the `assets/pic.png` file. You can use the `fs/promises` module to read the file.\n\n### --tests--\n\nYou can use `const imageBuffer = await readFile('assets/pic.png');` in `create-nft.js`.\n\n```js\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'imageBuffer';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /imageBuffer=(await readFile|readFileSync|read)\\(('|\"|`)(\\.\\/)?assets\\/pic\\.png\\2\\)/\n);\n```\n\nYou should import one of the file-reading API.\n\n```js\n// one of fs, fs/promises\n// one of readFileSync | readFile | read\nconst importDeclarations = babelisedCode.getImportDeclarations().filter(i => {\n return i.source.value === 'fs' || i.source.value === 'fs/promises';\n});\nassert.notEmpty(\n importDeclarations,\n 'An import from `fs` or `fs/promises` should exist'\n);\nconst importSpecifiers = importDeclarations.flatMap(i =>\n i.specifiers.map(s => s.imported.name)\n);\nconst fileReadingApis = ['readFile', 'readFileSync', 'read'];\nlet found = false;\nout: {\n for (const i of importSpecifiers) {\n for (const f of fileReadingApis) {\n if (i === f) {\n found = true;\n break out;\n }\n }\n }\n}\nassert.isTrue(found, 'One of the file-reading APIs should be imported');\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 25\n\n### --description--\n\nThe `@metaplex-foundation/js` module exports a `toMetaplexFile` function:\n\n```typescript\ntoMetaplexFile(\n content: MetaplexFileContent,\n fileName: string\n): MetaplexFile\n```\n\nThe `MetaplexFile` type contains useful metadata about the file which is useful for your NFT's metadata.\n\nDeclare a `file` variable, and set it to the result of calling `toMetaplexFile` with the `imageBuffer` and the filename `pic.png`.\n\n### --tests--\n\nYou should have `const file = toMetaplexFile(imageBuffer, 'pic.png');` in `create-nft.js`.\n\n```js\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'file';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /file=toMetaplexFile\\(imageBuffer,('|\"|`)?pic\\.png\\1\\)/\n);\n```\n\nYou should import `toMetaplexFile` from `@metaplex-foundation/js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@metaplex-foundation/js';\n});\nassert.exists(\n importDeclaration,\n 'An import from `@metaplex-foundation/js` should exist'\n);\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'toMetaplexFile',\n 'The `toMetaplexFile` function should be imported'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 26\n\n### --description--\n\nThe `Metaplex` class has a `storage` method that returns the storage driver configured earlier. The storage driver has an `upload` method that takes a `MetaplexFile` and returns a `Promise` that resolves to a `string` containing the URL of the uploaded file.\n\nDeclare an `image` variable, and set it to the result of awaiting `metaplex.storage().upload(file)`.\n\n### --tests--\n\nYou should have `const image = await metaplex.storage().upload(file);` in `create-nft.js`.\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'image';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /\\s+image=await metaplex\\.storage\\(\\)\\.upload\\(file\\)/\n);\n```\n\n## 27\n\n### --description--\n\nWith the URL to the uploaded image, you can upload the NFT's metadata. The `Metaplex` class has an `nfts` method that returns many useful methods for working with NFT's. One of these methods is `uploadMetadata`:\n\nError
\n\n```bash\nFailedToSendTransactionError: The transaction could not be sent successfully to the network. Please check the underlying error below for more details.\n\nSource: RPC\n\nCaused By: Error: failed to send transaction: Transaction simulation failed: Attempt to debit an account but found no record of a prior credit.\n```\n\n\n
\n\n```typescript\nuploadMetadata(\n input: {\n name?: string;\n symbol?: string;\n description?: string;\n seller_fee_basis_points?: number;\n image?: MetaplexFile;\n external_url?: MetaplexFile;\n attributes?: Array<{\n trait_type?: string;\n value?: string;\n [key: string]: unknown;\n }>;\n properties?: {\n creators?: Array<{\n address?: string;\n share?: number;\n [key: string]: unknown;\n }>;\n files?: Array<{\n type?: string;\n uri?: MetaplexFile;\n [key: string]: unknown;\n }>;\n [key: string]: unknown;\n };\n collection?: {\n name?: string;\n family?: string;\n [key: string]: unknown;\n };\n [key: string]: unknown;\n }\n): Promise\n```\n\n
\n\nThat is a lot of metadata! For now, you can just set the `name`, `description`, and `image` properties.\n\nDestructure the `uri` property from the result of awaiting `uploadMetadata`. Pass the `image` variable as the `image` property, and give the `name` and `description` properties some sane values.\n\n### --tests--\n\nYou should have `const { uri } = await metaplex.nfts().uploadMetadata({ name: 'any string', description: 'any string', image });` in `create-nft.js`.\n\n```js\nconst uriVariableDeclaration = babelisedCode\n .getVariableDeclarations()\n .find(v => {\n return v.declarations?.[0]?.id?.properties?.find(p => p.key.name === 'uri');\n });\nassert.exists(\n uriVariableDeclaration,\n 'A variable declaration with a `uri` property should exist'\n);\nconst codeString = babelisedCode.generateCode(uriVariableDeclaration);\n\nconst metaplex = `\nconst metaplex = {\n nfts: () => ({\n uploadMetadata: ({name, description, image}) => {\n if (typeof name !== 'string') {\n throw new Error('name must be a string');\n }\n if (typeof description !== 'string') {\n throw new Error('description must be a string');\n }\n return Promise.resolve({ uri: 'any string' });\n }\n })\n};\nlet image, name, description;\n`;\nconst testString = `${metaplex}\\n${codeString}`;\n\ntry {\n await eval(`(async () => {${testString}})()`);\n} catch (e) {\n assert.fail(e.message);\n}\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/create-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 28\n\n### --description--\n\nAnother method on the `nfts` object is `create`:\n\nuploadMetadata Signature
\n\n```typescript\nuploadMetadata(\n input: {\n name?: string;\n symbol?: string;\n description?: string;\n seller_fee_basis_points?: number;\n image?: MetaplexFile;\n external_url?: MetaplexFile;\n attributes?: Array<{\n trait_type?: string;\n value?: string;\n [key: string]: unknown;\n }>;\n properties?: {\n creators?: Array<{\n address?: string;\n share?: number;\n [key: string]: unknown;\n }>;\n files?: Array<{\n type?: string;\n uri?: MetaplexFile;\n [key: string]: unknown;\n }>;\n [key: string]: unknown;\n };\n collection?: {\n name?: string;\n family?: string;\n [key: string]: unknown;\n };\n [key: string]: unknown;\n }\n): Promise\n```\n\n\n
\n\n````typescript\ncreate(\n input: {\n /**\n * The authority that will be able to make changes\n * to the created NFT.\n *\n * This is required as a Signer because creating the master\n * edition account requires the update authority to sign\n * the transaction.\n *\n * @defaultValue `metaplex.identity()`\n */\n updateAuthority?: Signer;\n /**\n * The authority that is currently allowed to mint new tokens\n * for the provided mint account.\n *\n * Note that this is only relevant if the `useExistingMint` parameter\n * if provided.\n *\n * @defaultValue `metaplex.identity()`\n */\n mintAuthority?: Signer;\n /**\n * The address of the new mint account as a Signer.\n * This is useful if you already have a generated Keypair\n * for the mint account of the NFT to create.\n *\n * @defaultValue `Keypair.generateCode()`\n */\n useNewMint?: Signer;\n /**\n * The address of the existing mint account that should be converted\n * into an NFT. The account at this address should have the right\n * requirements to become an NFT, e.g. its supply should contains\n * exactly 1 token.\n *\n * @defaultValue Defaults to creating a new mint account with the\n * right requirements.\n */\n useExistingMint?: PublicKey;\n /**\n * Whether or not we should mint one token for the new NFT.\n *\n * @defaultValue `true`\n */\n mintTokens?: boolean;\n /**\n * The owner of the NFT to create.\n *\n * @defaultValue `metaplex.identity().publicKey`\n */\n tokenOwner?: PublicKey;\n /**\n * The token account linking the mint account and the token owner\n * together. By default, the associated token account will be used.\n *\n * If the provided token account does not exist, it must be passed as\n * a Signer as we will need to create it before creating the NFT.\n *\n * @defaultValue Defaults to creating a new associated token account\n * using the `mintAddress` and `tokenOwner` parameters.\n */\n tokenAddress?: PublicKey | Signer;\n /**\n * Describes the asset class of the token.\n * It can be one of the following:\n * - `TokenStandard.NonFungible`: A traditional NFT (master edition).\n * - `TokenStandard.FungibleAsset`: A fungible token with metadata that can also have attrributes.\n * - `TokenStandard.Fungible`: A fungible token with simple metadata.\n * - `TokenStandard.NonFungibleEdition`: A limited edition NFT \"printed\" from a master edition.\n * - `TokenStandard.ProgrammableNonFungible`: A master edition NFT with programmable configuration.\n *\n * @defaultValue `TokenStandard.NonFungible`\n */\n tokenStandard?: TokenStandard;\n /** The URI that points to the JSON metadata of the asset. */\n uri: string;\n /** The on-chain name of the asset, e.g. \"My NFT #123\". */\n name: string;\n /**\n * The royalties in percent basis point (i.e. 250 is 2.5%) that\n * should be paid to the creators on each secondary sale.\n */\n sellerFeeBasisPoints: number;\n /**\n * The on-chain symbol of the asset, stored in the Metadata account.\n * E.g. \"MYNFT\".\n *\n * @defaultValue `\"\"`\n */\n symbol?: string;\n /**\n * {@inheritDoc CreatorInput}\n * @defaultValue\n * Defaults to using the provided `updateAuthority` as the only verified creator.\n * ```ts\n * [{\n * address: updateAuthority.publicKey,\n * authority: updateAuthority,\n * share: 100,\n * }]\n * ```\n */\n creators?: CreatorInput[];\n /**\n * Whether or not the NFT's metadata is mutable.\n * When set to `false` no one can update the Metadata account,\n * not even the update authority.\n *\n * @defaultValue `true`\n */\n isMutable?: boolean;\n /**\n * Whether or not selling this asset is considered a primary sale.\n * Once flipped from `false` to `true`, this field is immutable and\n * all subsequent sales of this asset will be considered secondary.\n *\n * @defaultValue `false`\n */\n primarySaleHappened?: boolean;\n /**\n * The maximum supply of printed editions.\n * When this is `null`, an unlimited amount of editions\n * can be printed from the original edition.\n *\n * @defaultValue `toBigNumber(0)`\n */\n maxSupply?: Option;\n /**\n * When this field is not `null`, it indicates that the NFT\n * can be \"used\" by its owner or any approved \"use authorities\".\n *\n * @defaultValue `null`\n */\n uses?: Option;\n /**\n * Whether the created NFT is a Collection NFT.\n * When set to `true`, the NFT will be created as a\n * Sized Collection NFT with an initial size of 0.\n *\n * @defaultValue `false`\n */\n isCollection?: boolean;\n /**\n * The Collection NFT that this new NFT belongs to.\n * When `null`, the created NFT will not be part of a collection.\n *\n * @defaultValue `null`\n */\n collection?: Option;\n /**\n * The collection authority that should sign the created NFT\n * to prove that it is part of the provided collection.\n * When `null`, the provided `collection` will not be verified.\n *\n * @defaultValue `null`\n */\n collectionAuthority?: Option;\n /**\n * Whether or not the provided `collectionAuthority` is a delegated\n * collection authority, i.e. it was approved by the update authority\n * using `metaplex.nfts().approveCollectionAuthority()`.\n *\n * @defaultValue `false`\n */\n collectionAuthorityIsDelegated?: boolean;\n /**\n * Whether or not the provided `collection` is a sized collection\n * and not a legacy collection.\n *\n * @defaultValue `true`\n */\n collectionIsSized?: boolean;\n /**\n * The ruleset account that should be used to configure the\n * programmable NFT.\n *\n * This is only relevant for programmable NFTs, i.e. if the\n * `tokenStandard` is set to `TokenStandard.ProgrammableNonFungible`.\n *\n * @defaultValue `null`\n */\n ruleSet?: Option;\n }\n): Promise\n````\n\n
\n\nThe only required properties are `name`, `uri`, and `sellerFeeBasisPoints`. On top of those, you should also provide a `maxSupply` of `1` if you want to create a limited edition NFT.\n\nThe `create` method will take care of creating the mint account, the associated token account, the metadata PDA and the original edition PDA (a.k.a. the master edition) for you.\n\nDeclare a variable `createResponse`, and assign to it the result of awaiting the `create` method. Pass in the previously mentioned properties with sane values.\n\n### --tests--\n\nYou should have `const createResponse = await metaplex.nfts().create({ name: \"any string\", uri, sellerFeeBasisPoints: create Signature
\n\n````typescript\ncreate(\n input: {\n /**\n * The authority that will be able to make changes\n * to the created NFT.\n *\n * This is required as a Signer because creating the master\n * edition account requires the update authority to sign\n * the transaction.\n *\n * @defaultValue `metaplex.identity()`\n */\n updateAuthority?: Signer;\n /**\n * The authority that is currently allowed to mint new tokens\n * for the provided mint account.\n *\n * Note that this is only relevant if the `useExistingMint` parameter\n * if provided.\n *\n * @defaultValue `metaplex.identity()`\n */\n mintAuthority?: Signer;\n /**\n * The address of the new mint account as a Signer.\n * This is useful if you already have a generated Keypair\n * for the mint account of the NFT to create.\n *\n * @defaultValue `Keypair.generateCode()`\n */\n useNewMint?: Signer;\n /**\n * The address of the existing mint account that should be converted\n * into an NFT. The account at this address should have the right\n * requirements to become an NFT, e.g. its supply should contains\n * exactly 1 token.\n *\n * @defaultValue Defaults to creating a new mint account with the\n * right requirements.\n */\n useExistingMint?: PublicKey;\n /**\n * Whether or not we should mint one token for the new NFT.\n *\n * @defaultValue `true`\n */\n mintTokens?: boolean;\n /**\n * The owner of the NFT to create.\n *\n * @defaultValue `metaplex.identity().publicKey`\n */\n tokenOwner?: PublicKey;\n /**\n * The token account linking the mint account and the token owner\n * together. By default, the associated token account will be used.\n *\n * If the provided token account does not exist, it must be passed as\n * a Signer as we will need to create it before creating the NFT.\n *\n * @defaultValue Defaults to creating a new associated token account\n * using the `mintAddress` and `tokenOwner` parameters.\n */\n tokenAddress?: PublicKey | Signer;\n /**\n * Describes the asset class of the token.\n * It can be one of the following:\n * - `TokenStandard.NonFungible`: A traditional NFT (master edition).\n * - `TokenStandard.FungibleAsset`: A fungible token with metadata that can also have attrributes.\n * - `TokenStandard.Fungible`: A fungible token with simple metadata.\n * - `TokenStandard.NonFungibleEdition`: A limited edition NFT \"printed\" from a master edition.\n * - `TokenStandard.ProgrammableNonFungible`: A master edition NFT with programmable configuration.\n *\n * @defaultValue `TokenStandard.NonFungible`\n */\n tokenStandard?: TokenStandard;\n /** The URI that points to the JSON metadata of the asset. */\n uri: string;\n /** The on-chain name of the asset, e.g. \"My NFT #123\". */\n name: string;\n /**\n * The royalties in percent basis point (i.e. 250 is 2.5%) that\n * should be paid to the creators on each secondary sale.\n */\n sellerFeeBasisPoints: number;\n /**\n * The on-chain symbol of the asset, stored in the Metadata account.\n * E.g. \"MYNFT\".\n *\n * @defaultValue `\"\"`\n */\n symbol?: string;\n /**\n * {@inheritDoc CreatorInput}\n * @defaultValue\n * Defaults to using the provided `updateAuthority` as the only verified creator.\n * ```ts\n * [{\n * address: updateAuthority.publicKey,\n * authority: updateAuthority,\n * share: 100,\n * }]\n * ```\n */\n creators?: CreatorInput[];\n /**\n * Whether or not the NFT's metadata is mutable.\n * When set to `false` no one can update the Metadata account,\n * not even the update authority.\n *\n * @defaultValue `true`\n */\n isMutable?: boolean;\n /**\n * Whether or not selling this asset is considered a primary sale.\n * Once flipped from `false` to `true`, this field is immutable and\n * all subsequent sales of this asset will be considered secondary.\n *\n * @defaultValue `false`\n */\n primarySaleHappened?: boolean;\n /**\n * The maximum supply of printed editions.\n * When this is `null`, an unlimited amount of editions\n * can be printed from the original edition.\n *\n * @defaultValue `toBigNumber(0)`\n */\n maxSupply?: Option\n
\n\n### --tests--\n\nYou should run `node create-nft.js` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node create-nft.js',\n 'Run `node create-nft.js` in the terminal'\n);\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\nThe local storage driver should be running at `http://127.0.0.1:3001`.\n\n```js\ntry {\n const res = await fetch('http://127.0.0.1:3001/status/ping');\n // Response should be 200 with text \"pong\"\n if (res.status === 200) {\n const text = await res.text();\n if (text !== 'pong') {\n throw new Error(`Expected response text \"pong\", got ${text}`);\n }\n } else {\n throw new Error(`Expected status code 200, got ${res.status}`);\n }\n} catch (e) {\n assert.fail(e);\n}\n```\n\n## 32\n\n### --description--\n\nThe error comes about because the default Solana test validator does not come with the Metaplex Token program deployed.\n\nSo, the program needs to be manually deployed to the local cluster. To do this, first a dump of the program from mainnet needs to be created:\n\n```bash\nsolana program dump --url mainnet-beta metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s ./mlp_token.so\n```\n\nError
\n\n```bash\nFailedToSendTransactionError: The transaction could not be sent successfully to the network. Please check the underlying error below for more details.\n\nSource: RPC\n\nCaused By: Error: failed to send transaction: Transaction simulation failed: Attempt to load a program that does not exist\n```\n\n\n
\n\n### --tests--\n\nYou should have a file called `mlp_token.so` in the root of the project.\n\n```js\nconst fileExists = __helpers.fileExists(\n 'learn-the-metaplex-sdk-by-minting-an-nft/mlp_token.so'\n);\nassert.isTrue(fileExists, 'A file called `mlp_token.so` should exist.');\n```\n\n## 33\n\n### --description--\n\nDeploy the Metaplex Token program to your local cluster:\n\n```bash\nsolana program deploy --keypair wallet.json ./mlp_token.so\n```\n\n### --tests--\n\nYou should run `solana program deploy ./mlp_token.so` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'solana program deploy --keypair wallet.json ./mlp_token.so',\n 'Run `solana program deploy ./mlp_token.so` in the terminal'\n);\n```\n\n## 34\n\n### --description--\n\nRe-run the script to create the NFT.\n\n**Note:** You should see an error in the terminal.\n\n### --tests--\n\nYou should run `node create-nft.js` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node create-nft.js',\n 'Run `node create-nft.js` in the terminal'\n);\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\n\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\n\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\nThe local storage driver should be running at `http://127.0.0.1:3001`.\n\n```js\ntry {\n const res = await fetch('http://127.0.0.1:3001/status/ping');\n // Response should be 200 with text \"pong\"\n if (res.status === 200) {\n const text = await res.text();\n if (text !== 'pong') {\n throw new Error(`Expected response text \"pong\", got ${text}`);\n }\n } else {\n throw new Error(`Expected status code 200, got ${res.status}`);\n }\n} catch (e) {\n assert.fail(e);\n}\n```\n\n## 35\n\n### --description--\n\nThe error comes about because, internally, the Metaplex SDK is expecting a program address of `metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s`. However, when you deployed the `.so` file, it was deployed at a random public address.\n\nInstead, you can start the local cluster with the program pre-deployed at a specific address:\n\n```bash\nsolana-test-validator --bpf-program metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s ./mlp_token.so --reset\n```\n\nStop your existing local cluster, and start a new one with the above command.\n\nAbout the Command
\n\nThe above command:\n\n- Takes a dump of the program at the provided address\n- Uses the mainnet-beta cluster (the cluster that the Metaplex Token program is deployed to)\n- Outputs the dump to `mlp_token.so`\n\nThe address of the Metaplex Token program is `metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s`. You can find the address of any program you want by searching for it on the Solana Explorer:\n\n`https://explorer.solana.com/address/metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s`\n\n\n
\n\n### --tests--\n\nYou should be in the `learn-the-metaplex-sdk-by-minting-an-nft` directory.\n\n```js\nconst cwdFile = await __helpers.getCWD();\nconst cwd = cwdFile.split('\\n').filter(Boolean).pop();\nassert.include(cwd, 'learn-the-metaplex-sdk-by-minting-an-nft');\n```\n\nYou should run `solana-test-validator --bpf-program metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s ./mlp_token.so --reset` in the terminal.\n\n```js\nawait new Promise(res => setTimeout(() => res(), 2000));\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '\n {\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"getProgramAccounts\",\n \"params\": [\n \"BPFLoader2111111111111111111111111111111111\", {\n \"encoding\": \"base64\",\n \"dataSlice\": {\n \"length\": 0,\n \"offset\": 0\n }\n }\n ]\n}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.exists(\n jsonOut.result.find(\n r => r.pubkey === 'metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s'\n )\n );\n} catch (e) {\n assert.fail(\n e,\n 'Try running `solana-test-validator --bpf-program metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s ./mlp_token.so --reset`'\n );\n}\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nawait new Promise(res => setTimeout(() => res(), 2000));\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 36\n\n### --description--\n\nFor ease, this command has been added to the `package.json` file as a script. Stop your existing local cluster, and start a new one with the following command:\n\n```bash\nnpm run start:validator\n```\n\n**Note:** You might need to manually run the tests.\n\n### --tests--\n\nYou should run `npm run start:validator` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getTemp();\nassert.include(\n lastCommand,\n 'npm run start:validator',\n 'Run `npm run start:validator` in the terminal'\n);\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 37\n\n### --description--\n\nRestarting the validator with the `--reset` flag deletes any previous ledger data. This means you will need to airdrop some SOL into the account associated with `wallet.json` again.\n\nDo so.\n\n### --tests--\n\nThe `wallet.json` account should have at least 2 SOL.\n\n```js\nconst { stdout } = await __helpers.getCommandOutput(\n `solana balance ./learn-the-metaplex-sdk-by-minting-an-nft/wallet.json`\n);\nconst balance = stdout.trim()?.match(/\\d+/)?.[0];\nassert.isAtLeast(\n parseInt(balance),\n 2,\n 'Try running `solana airdrop 2 ./wallet.json`'\n);\n```\n\nThe validator should be running at `http://localhost:8899`.\n\n```js\nconst command = `curl http://localhost:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\n## 38\n\n### --description--\n\nCreate a new NFT again. Pay attention to the output in the terminal.\n\n### --tests--\n\nYou should run `node create-nft.js` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(\n lastCommand?.trim(),\n 'node create-nft.js',\n 'Run `node create-nft.js` in the terminal'\n);\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\nThe local storage driver should be running at `http://127.0.0.1:3001`.\n\n```js\ntry {\n const res = await fetch('http://127.0.0.1:3001/status/ping');\n // Response should be 200 with text \"pong\"\n if (res.status === 200) {\n const text = await res.text();\n if (text !== 'pong') {\n throw new Error(`Expected response text \"pong\", got ${text}`);\n }\n } else {\n throw new Error(`Expected status code 200, got ${res.status}`);\n }\n} catch (e) {\n assert.fail(e);\n}\n```\n\n## 39\n\n### --description--\n\nPart of the output should be the mint account's public key. Copy the base58 string and paste it into the `env.MINT_ACCOUNT_ADDRESS` property of the `package.json` file.\n\n_As this is a new NFT, the `env.MINT_ACCOUNT_ADDRESS` property will be different to the previous one._\n\n### --tests--\n\nThe `package.json` file should have a `env.MINT_ACCOUNT_ADDRESS` property.\n\n```js\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson,\n 'env',\n 'The `package.json` file should have an `env` property.'\n);\nassert.property(\n packageJson.env,\n 'MINT_ACCOUNT_ADDRESS',\n 'The `package.json` file should have an `env.MINT_ACCOUNT_ADDRESS` property.'\n);\n```\n\nThe `env.MINT_ACCOUNT_ADDRESS` property should match an NFT owned by `wallet.json`.\n\n```js\nconst command =\n 'solana address -k learn-the-metaplex-sdk-by-minting-an-nft/wallet.json';\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\nconst walletAddress = stdout.trim();\n\nconst packageJson = JSON.parse(\n await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/package.json'\n )\n);\nassert.property(\n packageJson,\n 'env',\n 'The `package.json` file should have an `env` property.'\n);\n\nassert.equal(\n packageJson.env.WALLET_ADDRESS,\n walletAddress,\n 'The `env.WALLET_ADDRESS` property should match the public key of `wallet.json`.'\n);\n\ntry {\n const { Connection } = await import('@solana/web3.js');\n const { TOKEN_PROGRAM_ID } = await import('@solana/spl-token');\n const connection = new Connection('http://127.0.0.1:8899');\n\n const mintAccounts = await connection.getParsedProgramAccounts(\n TOKEN_PROGRAM_ID,\n {\n filters: [\n {\n dataSize: 165\n },\n {\n memcmp: {\n offset: 32,\n bytes: packageJson.env.WALLET_ADDRESS\n }\n }\n ]\n }\n );\n\n const mintAccount = mintAccounts.find(\n ({ account }) =>\n account?.data?.parsed?.info?.mint === packageJson.env.MINT_ACCOUNT_ADDRESS\n );\n assert.exists(\n mintAccount,\n 'The `env.MINT_ACCOUNT_ADDRESS` property should match an NFT owned by `wallet.json`.'\n );\n} catch (e) {\n assert.fail(e);\n}\n```\n\n## 40\n\n### --description--\n\nNow that your NFT is deployed, and you have the mint account's public key, you can always find it using the public key.\n\nCreate a new file called `get-nft.js`.\n\n### --tests--\n\nYou should have a `get-nft.js` file.\n\n```js\nconst fileExists = __helpers.fileExists(\n 'learn-the-metaplex-sdk-by-minting-an-nft/get-nft.js'\n);\nassert.isTrue(fileExists, 'You should have a `get-nft.js` file.');\n```\n\n## 41\n\n### --description--\n\nWithin `get-nft.js`, declare a `connection` variable with a configuration pointing to your local cluster.\n\n### --tests--\n\nYou should have `const connection = new Connection('http://127.0.0.1:8899');` in `get-nft.js`.\n\n```js\nconst connectionVariableDeclaration = babelisedCode\n .getVariableDeclarations()\n .find(v => v.declarations?.[0]?.id?.name === 'connection');\nassert.exists(\n connectionVariableDeclaration,\n 'You should declare a variable named `connection`'\n);\nconst newExpression = connectionVariableDeclaration.declarations[0].init;\nassert.equal(\n newExpression.callee.name,\n 'Connection',\n 'You should initialise `connection` with a new `Connection`'\n);\nassert.equal(\n newExpression.arguments[0].value,\n 'http://127.0.0.1:8899',\n \"You should create a new connection with `new Connection('http://127.0.0.1:8899')`\"\n);\n```\n\nYou should import `Connection` from `@solana/web3.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@solana/web3.js';\n});\nassert.exists(importDeclaration, 'You should import from `@solana/web3.js`');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'Connection',\n '`Connection` should be imported from `@solana/spl-token`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/get-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 42\n\n### --description--\n\nWithin `get-nft.js`, declare a `metaplex` variable with the same configuration as the `metaplex` variable in `create-nft.js`.\n\n### --tests--\n\nYou should have `const metaplex = Metaplex.make(connection).use(keypairIdentity(WALLET_KEYPAIR)).use(localStorage({ baseUrl: 'http://127.0.0.1:3001/' }));` in `get-nft.js`.\n\n```js\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'metaplex';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /metaplex=Metaplex\\.make\\(connection\\)\\.use\\(keypairIdentity\\(WALLET_KEYPAIR\\)\\)\\.use\\(localStorage\\(\\{('|\"|`)?baseUrl\\1:('|\"|`)http:\\/\\/127\\.0\\.0\\.1:3001\\/\\2\\}\\)\\)/\n);\n```\n\nYou should import `Metaplex` from `@metaplex-foundation/js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@metaplex-foundation/js';\n});\nassert.exists(\n importDeclaration,\n 'You should import from `@metaplex-foundation/js`'\n);\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'Metaplex',\n '`Metaplex` should be imported from `@metaplex-foundation/js`'\n);\n```\n\nYou should import `keypairIdentity` from `@metaplex-foundation/js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@metaplex-foundation/js';\n});\nassert.exists(\n importDeclaration,\n 'You should import from `@metaplex-foundation/js`'\n);\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'keypairIdentity',\n '`keypairIdentity` should be imported from `@metaplex-foundation/js`'\n);\n```\n\nYou should import `WALLET_KEYPAIR` from `utils.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === './utils.js';\n});\nassert.exists(importDeclaration, 'You should import from `./utils.js`');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'WALLET_KEYPAIR',\n '`WALLET_KEYPAIR` should be imported from `./utils.js`'\n);\n```\n\nYou should import `localStorage` from `utils.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === './utils.js';\n});\nassert.exists(importDeclaration, 'You should import from `./utils.js`');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'localStorage',\n '`localStorage` should be imported from `./utils.js`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/get-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 43\n\n### --description--\n\nWithin `get-nft.js`, declare a `mintAddress` variable, and assign it the value of an instance of `PublicKey` constructed from the `MINT_ACCOUNT_ADDRESS` property from `pkg.env`.\n\n**Hint:** The `pkg` object is exported from `utils.js`.\n\n### --tests--\n\nYou should have `const mintAddress = new PublicKey(pkg.env.MINT_ACCOUNT_ADDRESS);` in `get-nft.js`.\n\n```js\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'mintAddress';\n});\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /mintAddress=new PublicKey\\(pkg\\.env\\.MINT_ACCOUNT_ADDRESS\\)/\n);\n```\n\nYou should import `pkg` from `utils.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === './utils.js';\n});\nassert.exists(importDeclaration, 'You should import from `./utils.js`');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'pkg',\n '`pkg` should be imported from `./utils.js`'\n);\n```\n\nYou should import `PublicKey` from `@solana/web3.js`.\n\n```js\nconst importDeclaration = babelisedCode.getImportDeclarations().find(i => {\n return i.source.value === '@solana/web3.js';\n});\nassert.exists(importDeclaration, 'You should import from `@solana/web3.js`');\nconst importSpecifiers = importDeclaration.specifiers.map(s => s.imported.name);\nassert.include(\n importSpecifiers,\n 'PublicKey',\n '`PublicKey` should be imported from `@solana/web3.js`'\n);\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/get-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 44\n\n### --description--\n\nTo get the NFT, use the `findByMint` method on the `Metaplex.nfts()` class:\n\n```typescript\nfindByMint(\n {\n mintAddress: PublicKey;\n tokenAddress?: PublicKey;\n tokenOwner?: PublicKey;\n loadJsonMetadata?: boolean;\n }\n): Promise\n```\n\nPass in the required `mintAddress` property, and assign the awaited result to an `nft` variable.\n\n### --tests--\n\nYou should have `const nft = await metaplex.nfts().findByMint({ mintAddress });` in `get-nft.js`.\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/get-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nconst variableDeclaration = babelisedCode.getVariableDeclarations().find(v => {\n return v.declarations?.[0]?.id?.name === 'nft';\n});\nassert.exists(variableDeclaration, 'An `nft` variable should exist');\nconst minifiedCode = babelisedCode.generateCode(variableDeclaration, {\n minified: true\n});\nassert.match(\n minifiedCode,\n /nft=await metaplex\\.nfts\\(\\)\\.findByMint\\(\\{mintAddress\\}\\)/\n);\n```\n\n## 45\n\n### --description--\n\nLog the `nft` variable to the console.\n\n### --tests--\n\nYou should have `console.log(nft);` in `get-nft.js`.\n\n```js\nconst consoleLogCallExpression = babelisedCode\n .getType('CallExpression')\n .find(c => {\n return (\n c.callee.object?.name === 'console' && c.callee.property?.name === 'log'\n );\n });\nassert.exists(consoleLogCallExpression, 'A `console.log` call should exist');\nconst consoleLogArguments = consoleLogCallExpression.arguments;\nconst ident = consoleLogArguments.find(a => {\n return a.name === 'nft';\n});\nassert.exists(ident, 'One of the arguments to `console.log` should be `nft`');\n```\n\n### --before-all--\n\n```js\nconst codeString = await __helpers.getFile(\n 'learn-the-metaplex-sdk-by-minting-an-nft/get-nft.js'\n);\nconst babelisedCode = new __helpers.Babeliser(codeString);\nglobal.babelisedCode = babelisedCode;\n```\n\n### --after-all--\n\n```js\ndelete global.babelisedCode;\n```\n\n## 46\n\n### --description--\n\nRun the `get-nft.js` script.\n\n```bash\nnode get-nft.js\n```\n\n### --tests--\n\nYou should run `node get-nft.js` in the terminal.\n\n```js\nconst lastCommand = await __helpers.getLastCommand();\nassert.equal(lastCommand?.trim(), 'node get-nft.js');\n```\n\nThe validator should be running at `http://127.0.0.1:8899`.\n\n```js\nconst command = `curl http://127.0.0.1:8899 -X POST -H \"Content-Type: application/json\" -d '{\"jsonrpc\":\"2.0\",\"id\":1, \"method\":\"getHealth\"}'`;\nconst { stdout, stderr } = await __helpers.getCommandOutput(command);\ntry {\n const jsonOut = JSON.parse(stdout);\n assert.deepInclude(jsonOut, { result: 'ok' });\n} catch (e) {\n assert.fail(e, 'Try running `solana-test-validator` in a separate terminal');\n}\n```\n\nThe local storage driver should be running at `http://127.0.0.1:3001`.\n\n```js\ntry {\n const res = await fetch('http://127.0.0.1:3001/status/ping');\n // Response should be 200 with text \"pong\"\n if (res.status === 200) {\n const text = await res.text();\n if (text !== 'pong') {\n throw new Error(`Expected response text \"pong\", got ${text}`);\n }\n } else {\n throw new Error(`Expected status code 200, got ${res.status}`);\n }\n} catch (e) {\n assert.fail(e);\n}\n```\n\n## 47\n\n### --description--\n\nNotice the output includes a `json` property. This is the metadata for the NFT.\n\nThe metadata includes the image URL, but not the image data itself. To get the image data, you can use the `download` method on the `Metaplex.storage()` class:\n\n```typescript\ndownload(\n uri: string\n): PromiseAbout the Command
\n\nThe `--bpf-program` flag is used to specify the address of the program. This is the same address that the program is deployed to on mainnet-beta. Internally, the Metaplex SDK uses this address in the transaction instructions to tell the cluster which program to use.\n\nThe `--reset` flag is used to clear the `test-ledger` directory. This is where the local cluster stores its data. If you don't clear the directory, the cluster will use the old data.\n\n| Turn: | \n\n | |
|---|---|---|
| Player: | \n\n | |
| \n | \n | \n |
| \n | \n | \n |
| \n | \n | \n |
\n
\n \n \n\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/app/index.js",
"content": "import { Keypair, PublicKey } from '@solana/web3.js';\nimport player_one_keypair from '../player-one.json';\nimport player_two_keypair from '../player-two.json';\nimport { displayError, removeLoader, showLoader } from './utils';\nimport { PROGRAM_ID, deriveGamePublicKey } from './web3';\n\nconst gameIdEl = document.getElementById('game-id');\nconst startGameBtnEl = document.getElementById('start-game');\nconst tableBodyEl = document.querySelector('tbody');\nconst tdEls = tableBodyEl.querySelectorAll('td');\nconst joinGameBtnEl = document.getElementById('join-game');\nconst playerOnePublicKeyEl = document.getElementById('player-one-public-key');\nconst playerTwoPublicKeyEl = document.getElementById('player-two-public-key');\nconst connectWalletBtnEl = document.getElementById('connect-wallet');\nconst keypairEl = document.getElementById('keypair');\nconst keypairsEl = document.getElementById('keypairs');\n\nconnectWalletBtnEl.addEventListener('click', ev => {\n ev.preventDefault();\n displayError();\n showLoader();\n try {\n const keypair = keypairEl.value;\n sessionStorage.setItem('keypair', keypair);\n\n // TODO: Connect to wallet\n\n connectWalletBtnEl.style.backgroundColor = 'green';\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n});\n\nstartGameBtnEl.addEventListener('click', async event => {\n event.preventDefault();\n displayError();\n showLoader();\n try {\n // TODO: Create a new game\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n});\n\njoinGameBtnEl.addEventListener('click', async event => {\n event.preventDefault();\n displayError();\n showLoader();\n try {\n // TODO: Join an existing game\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n});\n\ntdEls.forEach(tdEl => {\n tdEl.addEventListener('click', async event => {\n event.preventDefault();\n displayError();\n showLoader();\n try {\n // TODO: Play tile\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n });\n});\n\ndocument.addEventListener('DOMContentLoaded', async _event => {\n startWithPossibleValues();\n\n const interval = setInterval(async () => {\n showLoader();\n try {\n // TODO: If program and gamePublicKey exist, update board\n } catch (e) {\n console.debug(e);\n } finally {\n removeLoader();\n }\n }, 3000);\n\n // A game of tic-tac-toe should not last long,\n // but for development this is commented out\n // setTimeout(() => {\n // clearInterval(interval);\n // }, 300_000);\n return () => {\n clearInterval(interval);\n };\n});\n\n// ---------------------\n// CONVENIENCE FUNCTIONS\n// ---------------------\n\nfunction startWithPossibleValues() {\n const player_one_publicKey = Keypair.fromSecretKey(\n new Uint8Array(player_one_keypair)\n ).publicKey.toBase58();\n const player_two_publicKey = Keypair.fromSecretKey(\n new Uint8Array(player_two_keypair)\n ).publicKey.toBase58();\n\n playerOnePublicKeyEl.value = player_one_publicKey;\n playerTwoPublicKeyEl.value = player_two_publicKey;\n\n const keypairs = [player_one_keypair, player_two_keypair];\n keypairs.forEach((keypair, i) => {\n const li = document.createElement('li');\n const code = document.createElement('code');\n const pre = document.createElement('pre');\n pre.appendChild(code);\n code.textContent = JSON.stringify(keypair);\n li.textContent = `Player ${i + 1} Public Key: `;\n\n li.appendChild(pre);\n\n keypairsEl.appendChild(li);\n });\n}\n\nplayerOnePublicKeyEl.addEventListener('change', e => {\n const playerOnePublicKey = e.target.value;\n sessionStorage.setItem('playerOnePublicKey', playerOnePublicKey);\n});\n\nplayerTwoPublicKeyEl.addEventListener('change', e => {\n const playerTwoPublicKey = e.target.value;\n sessionStorage.setItem('playerTwoPublicKey', playerTwoPublicKey);\n});\n\ngameIdEl.addEventListener('change', e => {\n const gameId = e.target.value;\n sessionStorage.setItem('gameId', gameId);\n const gamePublicKey = deriveGamePublicKey(\n new PublicKey(playerOnePublicKeyEl.value),\n gameId,\n PROGRAM_ID\n );\n sessionStorage.setItem('gamePublicKey', gamePublicKey.toBase58());\n});\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/app/package.json",
"content": "{\n \"name\": \"app\",\n \"private\": true,\n \"version\": \"0.0.0\",\n \"type\": \"module\",\n \"scripts\": {\n \"dev\": \"vite\",\n \"build\": \"vite build\",\n \"preview\": \"vite preview\"\n },\n \"devDependencies\": {\n \"vite\": \"4.5.6\"\n },\n \"dependencies\": {}\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/app/utils.js",
"content": "const errorsEl = document.getElementById('errors');\nconst spinnerEl = document.getElementById('spinner');\n\nconst tableBodyEl = document.querySelector('tbody');\nconst tdEls = tableBodyEl.querySelectorAll('td');\n\n/**\n * @param {{ x: {} } | { o: {} } | null} tile\n * @returns 'X' | 'O' | ''\n */\nexport function tileToString(tile) {\n if (tile?.x) {\n return 'X';\n }\n if (tile?.o) {\n return 'O';\n }\n return '';\n}\n\n/**\n * @param {({ x: {} } | { o: {} } | null)[][]} board\n */\nexport function setTiles(board) {\n for (let i = 0; i < 3; i++) {\n for (let j = 0; j < 3; j++) {\n const tile = board[i][j];\n const tileEl = tdEls[i * 3 + j];\n tileEl.textContent = tileToString(tile);\n }\n }\n}\n\n/**\n * @param {Error | undefined} error\n */\nexport function displayError(error) {\n if (error) {\n console.error(error);\n errorsEl.innerText = error.message;\n } else {\n errorsEl.innerText = '';\n }\n}\n\n/**\n * @param {number} id\n * @returns {{ row: number; column: number }}\n */\nexport function idToTile(id) {\n for (let i = 0; i < 3; i++) {\n for (let j = 0; j < 3; j++) {\n const tile = tdEls[i * 3 + j];\n if (tile.id === id) {\n return { row: i, column: j };\n }\n }\n }\n}\n\nexport function showLoader() {\n spinnerEl.classList.remove('hidden');\n}\n\nexport function removeLoader() {\n spinnerEl.classList.add('hidden');\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/app/wallet.js",
"content": "export class Wallet {\n constructor(keypair) {\n this.keypair = keypair;\n this._publicKey = keypair.publicKey;\n }\n async signTransaction(tx) {\n tx.sign(this.keypair);\n return tx;\n }\n async signAllTransactions(txs) {\n txs.map(tx => tx.sign(this.keypair));\n return txs;\n }\n get publicKey() {\n return this._publicKey;\n }\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/migrations/deploy.ts",
"content": "// Migrations are an early feature. Currently, they're nothing more than this\n// single deploy script that's invoked from the CLI, injecting a provider\n// configured from the workspace's Anchor.toml.\n\nconst anchor = require(\"@coral-xyz/anchor\");\n\nmodule.exports = async function (provider) {\n // Configure client to use the provider.\n anchor.setProvider(provider);\n\n // Add your deploy script here.\n};\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/package.json",
"content": "{\n \"scripts\": {\n \"lint:fix\": \"prettier */*.js \\\"*/**/*{.js,.ts}\\\" -w\",\n \"lint\": \"prettier */*.js \\\"*/**/*{.js,.ts}\\\" --check\"\n },\n \"dependencies\": {\n \"@coral-xyz/anchor\": \"^0.28.0\"\n },\n \"devDependencies\": {\n \"@types/bn.js\": \"^5.1.0\",\n \"@types/chai\": \"^4.3.0\",\n \"@types/mocha\": \"^9.0.0\",\n \"chai\": \"^4.3.4\",\n \"mocha\": \"^9.0.3\",\n \"ts-mocha\": \"^10.0.0\",\n \"typescript\": \"^4.3.5\"\n }\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/programs/tic-tac-toe/Cargo.toml",
"content": "[package]\nname = \"tic-tac-toe\"\nversion = \"0.1.0\"\ndescription = \"Created with Anchor\"\nedition = \"2021\"\n\n[lib]\ncrate-type = [\"cdylib\", \"lib\"]\nname = \"tic_tac_toe\"\n\n[features]\nno-entrypoint = []\nno-idl = []\nno-log-ix-name = []\ncpi = [\"no-entrypoint\"]\ndefault = []\n\n[dependencies]\nanchor-lang = \"0.28.0\"\nnum-traits = \"0.2\"\nnum-derive = \"0.3\"\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/programs/tic-tac-toe/Xargo.toml",
"content": "[target.bpfel-unknown-unknown.dependencies.std]\nfeatures = []\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-1/tic-tac-toe/programs/tic-tac-toe/src/lib.rs",
"content": "use anchor_lang::prelude::*;\nuse num_derive;\nuse num_traits::FromPrimitive;\n\ndeclare_id!(\"5xGwZASoE5ZgxKgaisJNaGTGzMKzjyyBGv9FCUtu2m1c\");\n\n#[program]\npub mod tic_tac_toe {\n use super::*;\n\n pub fn setup_game(\n ctx: Context\n \n \n
\n | Turn: | \n\n | |
|---|---|---|
| Player: | \n\n | |
| \n | \n | \n |
| \n | \n | \n |
| \n | \n | \n |
\n
\n \n \n\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-2/app/index.js",
"content": "import { Keypair, PublicKey } from '@solana/web3.js';\nimport player_one_keypair from '../player-one.json';\nimport player_two_keypair from '../player-two.json';\nimport { displayError, removeLoader, showLoader } from './utils';\nimport {\n PROGRAM_ID,\n connectWallet,\n deriveGamePublicKey,\n handlePlay,\n startGame,\n updateBoard\n} from './web3';\n\nconst gameIdEl = document.getElementById('game-id');\nconst startGameBtnEl = document.getElementById('start-game');\nconst tableBodyEl = document.querySelector('tbody');\nconst tdEls = tableBodyEl.querySelectorAll('td');\nconst joinGameBtnEl = document.getElementById('join-game');\nconst playerOnePublicKeyEl = document.getElementById('player-one-public-key');\nconst playerTwoPublicKeyEl = document.getElementById('player-two-public-key');\nconst connectWalletBtnEl = document.getElementById('connect-wallet');\nconst keypairEl = document.getElementById('keypair');\nconst keypairsEl = document.getElementById('keypairs');\n\nconnectWalletBtnEl.addEventListener('click', ev => {\n ev.preventDefault();\n displayError();\n showLoader();\n try {\n const keypair = keypairEl.value;\n sessionStorage.setItem('keypair', keypair);\n\n // TODO: Connect to wallet\n connectWallet();\n\n connectWalletBtnEl.style.backgroundColor = 'green';\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n});\n\nstartGameBtnEl.addEventListener('click', async event => {\n event.preventDefault();\n displayError();\n showLoader();\n try {\n // TODO: Create a new game\n await startGame();\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n});\n\njoinGameBtnEl.addEventListener('click', async event => {\n event.preventDefault();\n displayError();\n showLoader();\n try {\n // TODO: Join an existing game\n await updateBoard();\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n});\n\ntdEls.forEach(tdEl => {\n tdEl.addEventListener('click', async event => {\n event.preventDefault();\n displayError();\n showLoader();\n try {\n // TODO: Play tile\n await handlePlay(event.target.id);\n } catch (e) {\n displayError(e);\n } finally {\n removeLoader();\n }\n });\n});\n\ndocument.addEventListener('DOMContentLoaded', async _event => {\n startWithPossibleValues();\n\n const interval = setInterval(async () => {\n showLoader();\n try {\n // TODO: If program and gamePublicKey exist, update board\n const gamePublicKey = sessionStorage.getItem('gamePublicKey');\n if (program && gamePublicKey) {\n await updateBoard();\n }\n } catch (e) {\n console.debug(e);\n } finally {\n removeLoader();\n }\n }, 3000);\n\n // A game of tic-tac-toe should not last long,\n // but for development this is commented out\n // setTimeout(() => {\n // clearInterval(interval);\n // }, 300_000);\n return () => {\n clearInterval(interval);\n };\n});\n\n// ---------------------\n// CONVENIENCE FUNCTIONS\n// ---------------------\n\nfunction startWithPossibleValues() {\n const player_one_publicKey = Keypair.fromSecretKey(\n new Uint8Array(player_one_keypair)\n ).publicKey.toBase58();\n const player_two_publicKey = Keypair.fromSecretKey(\n new Uint8Array(player_two_keypair)\n ).publicKey.toBase58();\n\n playerOnePublicKeyEl.value = player_one_publicKey;\n playerTwoPublicKeyEl.value = player_two_publicKey;\n\n const keypairs = [player_one_keypair, player_two_keypair];\n keypairs.forEach((keypair, i) => {\n const li = document.createElement('li');\n const code = document.createElement('code');\n const pre = document.createElement('pre');\n pre.appendChild(code);\n code.textContent = JSON.stringify(keypair);\n li.textContent = `Player ${i + 1} Public Key: `;\n\n li.appendChild(pre);\n\n keypairsEl.appendChild(li);\n });\n}\n\nplayerOnePublicKeyEl.addEventListener('change', e => {\n const playerOnePublicKey = e.target.value;\n sessionStorage.setItem('playerOnePublicKey', playerOnePublicKey);\n});\n\nplayerTwoPublicKeyEl.addEventListener('change', e => {\n const playerTwoPublicKey = e.target.value;\n sessionStorage.setItem('playerTwoPublicKey', playerTwoPublicKey);\n});\n\ngameIdEl.addEventListener('change', e => {\n const gameId = e.target.value;\n sessionStorage.setItem('gameId', gameId);\n const gamePublicKey = deriveGamePublicKey(\n new PublicKey(playerOnePublicKeyEl.value),\n gameId,\n PROGRAM_ID\n );\n sessionStorage.setItem('gamePublicKey', gamePublicKey.toBase58());\n});\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-2/app/package.json",
"content": "{\n \"name\": \"app\",\n \"private\": true,\n \"version\": \"0.0.0\",\n \"type\": \"module\",\n \"scripts\": {\n \"dev\": \"vite\",\n \"build\": \"vite build\",\n \"preview\": \"vite preview\"\n },\n \"devDependencies\": {\n \"vite\": \"4.5.6\"\n },\n \"dependencies\": {\n \"@solana/web3.js\": \"1.87.7\",\n \"@coral-xyz/anchor\": \"0.28.1-beta.1\"\n }\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-2/app/utils.js",
"content": "const errorsEl = document.getElementById('errors');\nconst spinnerEl = document.getElementById('spinner');\n\nconst tableBodyEl = document.querySelector('tbody');\nconst tdEls = tableBodyEl.querySelectorAll('td');\n\n/**\n * @param {{ x: {} } | { o: {} } | null} tile\n * @returns 'X' | 'O' | ''\n */\nexport function tileToString(tile) {\n if (tile?.x) {\n return 'X';\n }\n if (tile?.o) {\n return 'O';\n }\n return '';\n}\n\n/**\n * @param {({ x: {} } | { o: {} } | null)[][]} board\n */\nexport function setTiles(board) {\n for (let i = 0; i < 3; i++) {\n for (let j = 0; j < 3; j++) {\n const tile = board[i][j];\n const tileEl = tdEls[i * 3 + j];\n tileEl.textContent = tileToString(tile);\n }\n }\n}\n\n/**\n * @param {Error | undefined} error\n */\nexport function displayError(error) {\n if (error) {\n console.error(error);\n errorsEl.innerText = error.message;\n } else {\n errorsEl.innerText = '';\n }\n}\n\n/**\n * @param {number} id\n * @returns {{ row: number; column: number }}\n */\nexport function idToTile(id) {\n for (let i = 0; i < 3; i++) {\n for (let j = 0; j < 3; j++) {\n const tile = tdEls[i * 3 + j];\n if (tile.id === id) {\n return { row: i, column: j };\n }\n }\n }\n}\n\nexport function showLoader() {\n spinnerEl.classList.remove('hidden');\n}\n\nexport function removeLoader() {\n spinnerEl.classList.add('hidden');\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-2/app/wallet.js",
"content": "export class Wallet {\n constructor(keypair) {\n this.keypair = keypair;\n this._publicKey = keypair.publicKey;\n }\n async signTransaction(tx) {\n tx.sign(this.keypair);\n return tx;\n }\n async signAllTransactions(txs) {\n txs.map(tx => tx.sign(this.keypair));\n return txs;\n }\n get publicKey() {\n return this._publicKey;\n }\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-2/app/web3.js",
"content": "import { AnchorProvider, Program, setProvider } from '@coral-xyz/anchor';\nimport { Wallet } from './wallet.js';\nimport { IDL } from '../tic_tac_toe';\nimport { Connection, PublicKey, Keypair } from '@solana/web3.js';\nimport { Buffer } from 'buffer';\nimport { idToTile, setTiles } from './utils.js';\n\nconst turnEl = document.getElementById('turn');\nconst playerTurnEl = document.getElementById('player-turn');\n\nwindow.Buffer = Buffer;\nwindow.program = null;\n\nexport const PROGRAM_ID = new PublicKey(\n '5xGwZASoE5ZgxKgaisJNaGTGzMKzjyyBGv9FCUtu2m1c'\n);\n\nexport const connection = new Connection('http://localhost:8899', 'processed');\n\nexport function connectWallet() {\n const keypairArr = sessionStorage.getItem('keypair');\n const uint = new Uint8Array(JSON.parse(keypairArr));\n const keypair = Keypair.fromSecretKey(uint);\n const wallet = new Wallet(keypair);\n const provider = new AnchorProvider(connection, wallet, {});\n setProvider(provider);\n const program = new Program(IDL, PROGRAM_ID, provider);\n window.program = program;\n}\n\nexport async function startGame() {\n const gameId = sessionStorage.getItem('gameId');\n const playerOnePublicKey = new PublicKey(\n sessionStorage.getItem('playerOnePublicKey')\n );\n const playerTwoPublicKey = new PublicKey(\n sessionStorage.getItem('playerTwoPublicKey')\n );\n const gamePublicKey = deriveGamePublicKey(\n playerOnePublicKey,\n gameId,\n PROGRAM_ID\n );\n sessionStorage.setItem('gamePublicKey', gamePublicKey.toString());\n\n const keypairStr = sessionStorage.getItem('keypair');\n const keypairArr = JSON.parse(keypairStr);\n const uint8Arr = new Uint8Array(keypairArr);\n const keypair = Keypair.fromSecretKey(uint8Arr);\n await program.methods\n .setupGame(playerTwoPublicKey, gameId)\n .accounts({\n playerOne: keypair.publicKey,\n game: gamePublicKey\n })\n .signers([keypair])\n .rpc();\n await updateBoard();\n}\n\nexport async function handlePlay(id) {\n const tile = idToTile(id);\n\n await updateBoard();\n\n const keypairStr = sessionStorage.getItem('keypair');\n const keypairArr = JSON.parse(keypairStr);\n const uint8Arr = new Uint8Array(keypairArr);\n const keypair = Keypair.fromSecretKey(uint8Arr);\n const gamePublicKey = new PublicKey(sessionStorage.getItem('gamePublicKey'));\n await program.methods\n .play(tile)\n .accounts({\n player: keypair.publicKey,\n game: gamePublicKey\n })\n .signers([keypair])\n .rpc();\n await updateBoard();\n}\n\nexport function deriveGamePublicKey(playerOnePublicKey, gameId, programId) {\n const [gamePublicKey, _] = PublicKey.findProgramAddressSync(\n [Buffer.from('game'), playerOnePublicKey.toBuffer(), Buffer.from(gameId)],\n programId\n );\n return gamePublicKey;\n}\n\nexport async function getGameAccount() {\n const gamePublicKey = new PublicKey(sessionStorage.getItem('gamePublicKey'));\n const gameData = await program.account.game.fetch(gamePublicKey);\n turnEl.textContent = gameData.turn;\n playerTurnEl.textContent = gameData.turn % 2 === 0 ? 'O' : 'X';\n return gameData;\n}\n\nexport async function updateBoard() {\n const gameData = await getGameAccount();\n const board = gameData.board;\n\n setTiles(board);\n}\n"
},
{
"path": "learn-how-to-build-a-client-side-app-part-2/tic_tac_toe.ts",
"content": "export type TicTacToe = {\n \"version\": \"0.1.0\",\n \"name\": \"tic_tac_toe\",\n \"instructions\": [\n {\n \"name\": \"setupGame\",\n \"accounts\": [\n {\n \"name\": \"game\",\n \"isMut\": true,\n \"isSigner\": false\n },\n {\n \"name\": \"playerOne\",\n \"isMut\": true,\n \"isSigner\": true\n },\n {\n \"name\": \"systemProgram\",\n \"isMut\": false,\n \"isSigner\": false\n }\n ],\n \"args\": [\n {\n \"name\": \"playerTwoPubkey\",\n \"type\": \"publicKey\"\n },\n {\n \"name\": \"gameId\",\n \"type\": \"string\"\n }\n ]\n },\n {\n \"name\": \"play\",\n \"accounts\": [\n {\n \"name\": \"game\",\n \"isMut\": true,\n \"isSigner\": false\n },\n {\n \"name\": \"player\",\n \"isMut\": false,\n \"isSigner\": true\n }\n ],\n \"args\": [\n {\n \"name\": \"tile\",\n \"type\": {\n \"defined\": \"Tile\"\n }\n }\n ]\n }\n ],\n \"accounts\": [\n {\n \"name\": \"game\",\n \"type\": {\n \"kind\": \"struct\",\n \"fields\": [\n {\n \"name\": \"players\",\n \"type\": {\n \"array\": [\n \"publicKey\",\n 2\n ]\n }\n },\n {\n \"name\": \"turn\",\n \"type\": \"u8\"\n },\n {\n \"name\": \"board\",\n \"type\": {\n \"array\": [\n {\n \"array\": [\n {\n \"option\": {\n \"defined\": \"Sign\"\n }\n },\n 3\n ]\n },\n 3\n ]\n }\n },\n {\n \"name\": \"state\",\n \"type\": {\n \"defined\": \"GameState\"\n }\n }\n ]\n }\n }\n ],\n \"types\": [\n {\n \"name\": \"Tile\",\n \"type\": {\n \"kind\": \"struct\",\n \"fields\": [\n {\n \"name\": \"row\",\n \"type\": \"u8\"\n },\n {\n \"name\": \"column\",\n \"type\": \"u8\"\n }\n ]\n }\n },\n {\n \"name\": \"GameState\",\n \"type\": {\n \"kind\": \"enum\",\n \"variants\": [\n {\n \"name\": \"Active\"\n },\n {\n \"name\": \"Tie\"\n },\n {\n \"name\": \"Won\",\n \"fields\": [\n {\n \"name\": \"winner\",\n \"type\": \"publicKey\"\n }\n ]\n }\n ]\n }\n },\n {\n \"name\": \"Sign\",\n \"type\": {\n \"kind\": \"enum\",\n \"variants\": [\n {\n \"name\": \"X\"\n },\n {\n \"name\": \"O\"\n }\n ]\n }\n }\n ],\n \"errors\": [\n {\n \"code\": 6000,\n \"name\": \"TileOutOfBounds\"\n },\n {\n \"code\": 6001,\n \"name\": \"TileAlreadySet\"\n },\n {\n \"code\": 6002,\n \"name\": \"GameAlreadyOver\"\n },\n {\n \"code\": 6003,\n \"name\": \"NotPlayersTurn\"\n },\n {\n \"code\": 6004,\n \"name\": \"GameAlreadyStarted\"\n }\n ]\n};\n\nexport const IDL: TicTacToe = {\n \"version\": \"0.1.0\",\n \"name\": \"tic_tac_toe\",\n \"instructions\": [\n {\n \"name\": \"setupGame\",\n \"accounts\": [\n {\n \"name\": \"game\",\n \"isMut\": true,\n \"isSigner\": false\n },\n {\n \"name\": \"playerOne\",\n \"isMut\": true,\n \"isSigner\": true\n },\n {\n \"name\": \"systemProgram\",\n \"isMut\": false,\n \"isSigner\": false\n }\n ],\n \"args\": [\n {\n \"name\": \"playerTwoPubkey\",\n \"type\": \"publicKey\"\n },\n {\n \"name\": \"gameId\",\n \"type\": \"string\"\n }\n ]\n },\n {\n \"name\": \"play\",\n \"accounts\": [\n {\n \"name\": \"game\",\n \"isMut\": true,\n \"isSigner\": false\n },\n {\n \"name\": \"player\",\n \"isMut\": false,\n \"isSigner\": true\n }\n ],\n \"args\": [\n {\n \"name\": \"tile\",\n \"type\": {\n \"defined\": \"Tile\"\n }\n }\n ]\n }\n ],\n \"accounts\": [\n {\n \"name\": \"game\",\n \"type\": {\n \"kind\": \"struct\",\n \"fields\": [\n {\n \"name\": \"players\",\n \"type\": {\n \"array\": [\n \"publicKey\",\n 2\n ]\n }\n },\n {\n \"name\": \"turn\",\n \"type\": \"u8\"\n },\n {\n \"name\": \"board\",\n \"type\": {\n \"array\": [\n {\n \"array\": [\n {\n \"option\": {\n \"defined\": \"Sign\"\n }\n },\n 3\n ]\n },\n 3\n ]\n }\n },\n {\n \"name\": \"state\",\n \"type\": {\n \"defined\": \"GameState\"\n }\n }\n ]\n }\n }\n ],\n \"types\": [\n {\n \"name\": \"Tile\",\n \"type\": {\n \"kind\": \"struct\",\n \"fields\": [\n {\n \"name\": \"row\",\n \"type\": \"u8\"\n },\n {\n \"name\": \"column\",\n \"type\": \"u8\"\n }\n ]\n }\n },\n {\n \"name\": \"GameState\",\n \"type\": {\n \"kind\": \"enum\",\n \"variants\": [\n {\n \"name\": \"Active\"\n },\n {\n \"name\": \"Tie\"\n },\n {\n \"name\": \"Won\",\n \"fields\": [\n {\n \"name\": \"winner\",\n \"type\": \"publicKey\"\n }\n ]\n }\n ]\n }\n },\n {\n \"name\": \"Sign\",\n \"type\": {\n \"kind\": \"enum\",\n \"variants\": [\n {\n \"name\": \"X\"\n },\n {\n \"name\": \"O\"\n }\n ]\n }\n }\n ],\n \"errors\": [\n {\n \"code\": 6000,\n \"name\": \"TileOutOfBounds\"\n },\n {\n \"code\": 6001,\n \"name\": \"TileAlreadySet\"\n },\n {\n \"code\": 6002,\n \"name\": \"GameAlreadyOver\"\n },\n {\n \"code\": 6003,\n \"name\": \"NotPlayersTurn\"\n },\n {\n \"code\": 6004,\n \"name\": \"GameAlreadyStarted\"\n }\n ]\n};\n"
},
{
"path": "learn-how-to-build-for-mainnet/_answer/Anchor.toml",
"content": "[features]\nseeds = false\nskip-lint = false\nskip-preflight = true\n[programs.localnet]\ntodo = \"9a43FDYE3S98dfN1rPAeavJT6MzBUEuF3bdX94zihQG2\"\n\n[registry]\nurl = \"https://api.apr.dev\"\n\n[provider]\ncluster = \"Localnet\"\nwallet = \"~/.config/solana/id.json\"\n\n[scripts]\ntest = \"yarn run ts-mocha -p ./tsconfig.json -t 1000000 tests/**/*.ts\"\n"
},
{
"path": "learn-how-to-build-for-mainnet/_answer/Cargo.toml",
"content": "[workspace]\nmembers = [\n \"programs/*\"\n]\n\n[profile.release]\noverflow-checks = true\nlto = \"fat\"\ncodegen-units = 1\n[profile.release.build-override]\nopt-level = 3\nincremental = false\ncodegen-units = 1\n"
},
{
"path": "learn-how-to-build-for-mainnet/_answer/app/index.html",
"content": "\n\n \n \n \n \n \n \n \n
\n \n
\n );\n}\n\nfunction Landing() {\n const [tasks, setTasks] = useStateConnect and Login
\n \n\n \n {taskList}\n \n
\n );\n}\n\nfunction TodoC({\n name,\n id,\n editTask,\n toggleTaskCompleted,\n deleteTask,\n completed\n}: TodoT) {\n const [isEditing, setEditing] = useState(false);\n const [newName, setNewName] = useState('');\n\n const editFieldRef = useRefToDos
\n \n\n {FILTER_NAMES.map(name => (\n
\n \n \n {headingText}\n
\n\n
\n );\n\n useEffect(() => {\n if (!wasEditing && isEditing) {\n editFieldRef?.current?.focus();\n }\n if (wasEditing && !isEditing) {\n editButtonRef?.current?.focus();\n }\n }, [wasEditing, isEditing]);\n\n return \n toggleTaskCompleted(id)}\n />\n \n
\n \n setEditing(true)}\n ref={editButtonRef}\n >\n Edit {name}\n \n deleteTask(id)}\n >\n Delete {name}\n \n
\n \n
\n );\n}\n\nfunction Landing() {\n const [tasks, setTasks] = useStateConnect and Login
\n \n\n \n {taskList}\n \n
\n );\n}\n\nfunction TodoC({\n name,\n id,\n editTask,\n toggleTaskCompleted,\n deleteTask,\n completed\n}: TodoT) {\n const [isEditing, setEditing] = useState(false);\n const [newName, setNewName] = useState('');\n\n const editFieldRef = useRefToDos
\n \n\n {FILTER_NAMES.map(name => (\n
\n \n \n {headingText}\n
\n\n
\n );\n\n useEffect(() => {\n if (!wasEditing && isEditing) {\n editFieldRef?.current?.focus();\n }\n if (wasEditing && !isEditing) {\n editButtonRef?.current?.focus();\n }\n }, [wasEditing, isEditing]);\n\n return \n toggleTaskCompleted(id)}\n />\n \n
\n \n setEditing(true)}\n ref={editButtonRef}\n >\n Edit {name}\n \n deleteTask(id)}\n >\n Delete {name}\n \n
\n