From f595ffec412fe81361c756f88e75592528ac1e73 Mon Sep 17 00:00:00 2001 From: Lucas Tortora Date: Wed, 13 Nov 2024 21:21:21 -0300 Subject: [PATCH 1/7] feat(devx) - alter sidebars --- docs/content/sidebars/developer.js | 348 ++++++++++++++-------------- docs/content/sidebars/references.js | 198 ++-------------- docs/content/sidebars/ts-sdk.js | 133 +++++++++++ docs/site/src/pages/index.js | 2 +- 4 files changed, 325 insertions(+), 356 deletions(-) create mode 100644 docs/content/sidebars/ts-sdk.js diff --git a/docs/content/sidebars/developer.js b/docs/content/sidebars/developer.js index 1ce2575c18b..d97cad27c59 100644 --- a/docs/content/sidebars/developer.js +++ b/docs/content/sidebars/developer.js @@ -4,6 +4,7 @@ const developer = [ 'developer/developer', + 'developer/network-overview', { type: 'category', label: 'Getting Started', @@ -19,7 +20,7 @@ const developer = [ 'developer/getting-started/local-network', 'developer/getting-started/get-address', 'developer/getting-started/get-coins', - //'developer/getting-started/graphql-rpc', + 'developer/getting-started/graphql-rpc', 'developer/getting-started/create-a-package', 'developer/getting-started/create-a-module', 'developer/getting-started/build-test', @@ -29,241 +30,162 @@ const developer = [ 'developer/getting-started/coffee-example', ], }, - 'developer/network-overview', { type: 'category', - label: 'IOTA 101', - link: { - type: 'doc', - id: 'developer/iota-101', - }, + label: 'Move Overview', items: [ + 'developer/move-overview/move-overview', + 'developer/move-overview/strings', + 'developer/move-overview/collections', + 'developer/move-overview/init', + 'developer/move-overview/visibility', + 'developer/move-overview/entry-functions', { type: 'category', - label: 'Move Overview', + label: 'Structs and Abilities', items: [ - 'developer/iota-101/move-overview/move-overview', - 'developer/iota-101/move-overview/strings', - 'developer/iota-101/move-overview/collections', - 'developer/iota-101/move-overview/init', - 'developer/iota-101/move-overview/visibility', - 'developer/iota-101/move-overview/entry-functions', - { - type: 'category', - label: 'Structs and Abilities', - items: [ - 'developer/iota-101/move-overview/structs-and-abilities/struct', - 'developer/iota-101/move-overview/structs-and-abilities/copy', - 'developer/iota-101/move-overview/structs-and-abilities/drop', - 'developer/iota-101/move-overview/structs-and-abilities/key', - 'developer/iota-101/move-overview/structs-and-abilities/store', - ], - }, - 'developer/iota-101/move-overview/one-time-witness', - { - type: 'category', - label: 'Package Upgrades', - items: [ - 'developer/iota-101/move-overview/package-upgrades/introduction', - 'developer/iota-101/move-overview/package-upgrades/upgrade', - 'developer/iota-101/move-overview/package-upgrades/automated-address-management', - 'developer/iota-101/move-overview/package-upgrades/custom-policies', - ], - }, - 'developer/iota-101/move-overview/ownership-scope', - 'developer/iota-101/move-overview/references', - 'developer/iota-101/move-overview/generics', - { - type: 'category', - label: 'Patterns', - items: [ - 'developer/iota-101/move-overview/patterns/patterns', - 'developer/iota-101/move-overview/patterns/capabilities', - 'developer/iota-101/move-overview/patterns/witness', - 'developer/iota-101/move-overview/patterns/transferable-witness', - 'developer/iota-101/move-overview/patterns/hot-potato', - 'developer/iota-101/move-overview/patterns/id-pointer', - ], - }, - 'developer/iota-101/move-overview/conventions', + 'developer/move-overview/structs-and-abilities/struct', + 'developer/move-overview/structs-and-abilities/copy', + 'developer/move-overview/structs-and-abilities/drop', + 'developer/move-overview/structs-and-abilities/key', + 'developer/move-overview/structs-and-abilities/store', ], }, - //'developer/graphql-rpc', + 'developer/move-overview/one-time-witness', { type: 'category', - label: 'Object Model', + label: 'Package Upgrades', items: [ - 'developer/iota-101/objects/object-model', - 'developer/iota-101/objects/shared-owned', - { - type: 'category', - label: 'Object Ownership', - link: { - type: 'doc', - id: 'developer/iota-101/objects/object-ownership/object-ownership', - }, - items: [ - 'developer/iota-101/objects/object-ownership/address-owned', - 'developer/iota-101/objects/object-ownership/immutable', - 'developer/iota-101/objects/object-ownership/shared', - 'developer/iota-101/objects/object-ownership/wrapped', - ], - }, - 'developer/iota-101/objects/uid-id', - { - type: 'category', - label: 'Dynamic Fields', - link: { - type: 'doc', - id: 'developer/iota-101/objects/dynamic-fields/dynamic-fields', - }, - items: ['developer/iota-101/objects/dynamic-fields/tables-bags'], - }, - { - type: 'category', - label: 'Transfers', - link: { - type: 'doc', - id: 'developer/iota-101/objects/transfers/transfers', - }, - items: [ - 'developer/iota-101/objects/transfers/custom-rules', - 'developer/iota-101/objects/transfers/transfer-to-object', - ], - }, - 'developer/iota-101/objects/events', - 'developer/iota-101/objects/versioning', + 'developer/move-overview/package-upgrades/introduction', + 'developer/move-overview/package-upgrades/upgrade', + 'developer/move-overview/package-upgrades/automated-address-management', + 'developer/move-overview/package-upgrades/custom-policies', ], }, + 'developer/move-overview/ownership-scope', + 'developer/move-overview/references', + 'developer/move-overview/generics', { type: 'category', - label: 'Transactions', + label: 'Patterns', + items: [ + 'developer/move-overview/patterns/patterns', + 'developer/move-overview/patterns/capabilities', + 'developer/move-overview/patterns/witness', + 'developer/move-overview/patterns/transferable-witness', + 'developer/move-overview/patterns/hot-potato', + 'developer/move-overview/patterns/id-pointer', + ], + }, + 'developer/move-overview/conventions', + ], + }, + 'developer/graphql-rpc', + { + type: 'category', + label: 'Object Model', + items: [ + 'developer/objects/object-model', + 'developer/objects/shared-owned', + { + type: 'category', + label: 'Object Ownership', link: { type: 'doc', - id: 'developer/iota-101/transactions/transactions', + id: 'developer/objects/object-ownership/object-ownership', }, items: [ - 'developer/iota-101/transactions/sign-and-send-transactions', - { - type: 'category', - label: 'Sponsored Transactions', - link: { - type: 'doc', - id: 'developer/iota-101/transactions/sponsored-transactions/about-sponsored-transactions', - }, - items: [ - 'developer/iota-101/transactions/sponsored-transactions/about-sponsored-transactions', - 'developer/iota-101/transactions/sponsored-transactions/use-sponsored-transactions'], - }, - { - type: 'category', - label: 'Working with PTBs', - link: { - type: 'doc', - id:'developer/iota-101/transactions/ptb/programmable-transaction-blocks-overview', - }, - items: [ - 'developer/iota-101/transactions/ptb/programmable-transaction-blocks', - 'developer/iota-101/transactions/ptb/building-programmable-transaction-blocks-ts-sdk', - 'developer/iota-101/transactions/ptb/simulating-references', - 'developer/iota-101/transactions/ptb/coin-management', - 'developer/iota-101/transactions/ptb/optimizing-gas-with-coin-merging', - - ], - }, + 'developer/objects/object-ownership/address-owned', + 'developer/objects/object-ownership/immutable', + 'developer/objects/object-ownership/shared', + 'developer/objects/object-ownership/wrapped', ], }, + 'developer/objects/uid-id', { type: 'category', - label: 'Create Coins and Tokens', + label: 'Dynamic Fields', link: { type: 'doc', - id: 'developer/iota-101/create-coin/create-coin', + id: 'developer/objects/dynamic-fields/dynamic-fields', }, - items: [ - 'developer/iota-101/create-coin/regulated', - 'developer/iota-101/create-coin/migrate-to-coin-manager', - 'developer/iota-101/create-coin/in-game-token', - 'developer/iota-101/create-coin/loyalty', - ], + items: ['developer/objects/dynamic-fields/tables-bags'], }, { - type:'category', - label: 'NFT', + type: 'category', + label: 'Transfers', + link: { + type: 'doc', + id: 'developer/objects/transfers/transfers', + }, items: [ - 'developer/iota-101/nft/create-nft', - 'developer/iota-101/nft/rent-nft', - ] + 'developer/objects/transfers/custom-rules', + 'developer/objects/transfers/transfer-to-object', + ], }, - 'developer/iota-101/using-events', - 'developer/iota-101/access-time', + 'developer/objects/events', + 'developer/objects/versioning', ], }, { type: 'category', - label: 'Capture The Flag', + label: 'Transactions', link: { type: 'doc', - id: 'developer/iota-move-ctf/introduction', + id: 'developer/transactions/transactions', }, items: [ - 'developer/iota-move-ctf/challenge_1', - 'developer/iota-move-ctf/challenge_2', - 'developer/iota-move-ctf/challenge_3', - 'developer/iota-move-ctf/challenge_4', - 'developer/iota-move-ctf/challenge_5', - 'developer/iota-move-ctf/challenge_6', - 'developer/iota-move-ctf/challenge_7', - 'developer/iota-move-ctf/challenge_8', - ], - }, - { - type: 'category', - label: 'Standards', - link: { - type: 'generated-index', - title:'IOTA Standards Overview', - description: 'Standards on the IOTA blockchain are features, frameworks, or apps that you can extend or customize.', - slug: 'developer/standards', - }, - items: [ - 'developer/standards/coin', - 'developer/standards/coin-manager', + 'developer/transactions/sign-and-send-transactions', { type: 'category', - label: 'Closed-Loop Token', + label: 'Sponsored Transactions', link: { type: 'doc', - id: 'developer/standards/closed-loop-token', + id: 'developer/transactions/sponsored-transactions/about-sponsored-transactions', }, items: [ - 'developer/standards/closed-loop-token/action-request', - 'developer/standards/closed-loop-token/token-policy', - 'developer/standards/closed-loop-token/spending', - 'developer/standards/closed-loop-token/rules', - 'developer/standards/closed-loop-token/coin-token-comparison', + 'developer/transactions/sponsored-transactions/about-sponsored-transactions', + 'developer/transactions/sponsored-transactions/use-sponsored-transactions'], + }, + { + type: 'category', + label: 'Working with PTBs', + link: { + type: 'doc', + id:'developer/transactions/ptb/programmable-transaction-blocks-overview', + }, + items: [ + 'developer/transactions/ptb/programmable-transaction-blocks', + 'developer/transactions/ptb/building-programmable-transaction-blocks-ts-sdk', + 'developer/transactions/ptb/simulating-references', + 'developer/transactions/ptb/coin-management', + 'developer/transactions/ptb/optimizing-gas-with-coin-merging', + ], }, - 'developer/standards/kiosk', - 'developer/standards/kiosk-apps', - 'developer/standards/display', - 'developer/standards/wallet-standard', ], }, { type: 'category', - label: 'From Solidity/EVM to Move', - collapsed: true, + label: 'Create Coins and Tokens', link: { type: 'doc', - id: 'developer/evm-to-move/evm-to-move', + id: 'developer/create-coin/create-coin', }, items: [ - 'developer/evm-to-move/tooling-apis', - 'developer/evm-to-move/creating-token', - 'developer/evm-to-move/creating-nft', + 'developer/create-coin/regulated', + 'developer/create-coin/migrate-to-coin-manager', + 'developer/create-coin/in-game-token', + 'developer/create-coin/loyalty', ], }, + { + type: 'category', + label: 'NFT', + items: ['developer/nft/create-nft', 'developer/nft/rent-nft'], + }, + 'developer/using-events', + 'developer/access-time', { type: 'category', label: 'Cryptography', @@ -304,6 +226,71 @@ const developer = [ }, ], }, + { + type: 'category', + label: 'Standards', + link: { + type: 'generated-index', + title:'IOTA Standards Overview', + description: 'Standards on the IOTA blockchain are features, frameworks, or apps that you can extend or customize.', + slug: 'developer/standards', + }, + items: [ + 'developer/standards/coin', + 'developer/standards/coin-manager', + { + type: 'category', + label: 'Closed-Loop Token', + link: { + type: 'doc', + id: 'developer/standards/closed-loop-token', + }, + items: [ + 'developer/standards/closed-loop-token/action-request', + 'developer/standards/closed-loop-token/token-policy', + 'developer/standards/closed-loop-token/spending', + 'developer/standards/closed-loop-token/rules', + 'developer/standards/closed-loop-token/coin-token-comparison', + ], + }, + 'developer/standards/kiosk', + 'developer/standards/kiosk-apps', + 'developer/standards/display', + 'developer/standards/wallet-standard', + ], + }, + { + type: 'category', + label: 'Capture The Flag', + link: { + type: 'doc', + id: 'developer/iota-move-ctf/introduction', + }, + items: [ + 'developer/iota-move-ctf/challenge_1', + 'developer/iota-move-ctf/challenge_2', + 'developer/iota-move-ctf/challenge_3', + 'developer/iota-move-ctf/challenge_4', + 'developer/iota-move-ctf/challenge_5', + 'developer/iota-move-ctf/challenge_6', + 'developer/iota-move-ctf/challenge_7', + 'developer/iota-move-ctf/challenge_8', + ], + }, + { + type: 'category', + label: 'From Solidity/EVM to Move', + collapsed: true, + link: { + type: 'doc', + id: 'developer/evm-to-move/evm-to-move', + }, + items: [ + 'developer/evm-to-move/tooling-apis', + 'developer/evm-to-move/creating-token', + 'developer/evm-to-move/creating-nft', + ], + }, { type: 'category', label: 'Advanced Topics', @@ -315,6 +302,7 @@ const developer = [ 'developer/advanced/introducing-move-2024', 'developer/advanced/iota-repository', 'developer/advanced/custom-indexer', + 'developer/advanced/graphql-migration', 'developer/advanced/onchain-randomness', 'developer/advanced/asset-tokenization', ], diff --git a/docs/content/sidebars/references.js b/docs/content/sidebars/references.js index fbfcb147ed0..7c27953d5aa 100644 --- a/docs/content/sidebars/references.js +++ b/docs/content/sidebars/references.js @@ -2,7 +2,6 @@ // Modifications Copyright (c) 2024 IOTA Stiftung // SPDX-License-Identifier: Apache-2.0 -import typedocSidebar from '../references/ts-sdk/api/typedoc-sidebar.cjs'; const references = [ { type: 'doc', @@ -12,26 +11,25 @@ const references = [ { type: 'category', label: 'IOTA RPC', - collapsed: false, link: { type: 'doc', id: 'references/iota-api', }, items: [ { - type: 'category', - label: 'GraphQL', - link: { - type: 'doc', - id: 'references/iota-graphql', - }, - items: [ - { - type: 'autogenerated', - dirName: 'references/iota-api/iota-graphql/reference', - }, - ], - }, + type: 'category', + label: 'GraphQL', + link: { + type: 'doc', + id: 'references/iota-graphql', + }, + items: [ + { + type: 'autogenerated', + dirName: 'references/iota-api/iota-graphql/reference', + }, + ], + }, { type: 'link', label: 'JSON-RPC', @@ -44,7 +42,6 @@ const references = [ { type: 'category', label: 'IOTA CLI', - collapsed: false, link: { type: 'doc', id: 'references/cli', @@ -60,153 +57,10 @@ const references = [ 'references/cli/cheatsheet', ], }, - { - type: 'category', - label: 'IOTA SDKs', - collapsed: false, - link: { - type: 'doc', - id: 'references/iota-sdks', - }, - items: [ - 'references/rust-sdk', - { - type: 'category', - label: 'IOTA TypeScript Documentation', - items: [ - { - type: 'category', - label: 'Typescript SDK', - items: [ - 'references/ts-sdk/typescript/index', - 'references/ts-sdk/typescript/install', - 'references/ts-sdk/typescript/hello-iota', - 'references/ts-sdk/typescript/faucet', - 'references/ts-sdk/typescript/iota-client', - { - type: 'category', - label: 'Transaction Building', - items: [ - 'references/ts-sdk/typescript/transaction-building/basics', - 'references/ts-sdk/typescript/transaction-building/gas', - 'references/ts-sdk/typescript/transaction-building/sponsored-transactions', - 'references/ts-sdk/typescript/transaction-building/offline', - ], - }, - { - type: 'category', - label: 'Cryptography', - items: [ - 'references/ts-sdk/typescript/cryptography/keypairs', - 'references/ts-sdk/typescript/cryptography/multisig', - ], - }, - 'references/ts-sdk/typescript/utils', - 'references/ts-sdk/typescript/bcs', - { - type: 'category', - label: 'Owned Object Pool', - items: [ - 'references/ts-sdk/typescript/owned-object-pool/index', - 'references/ts-sdk/typescript/owned-object-pool/overview', - 'references/ts-sdk/typescript/owned-object-pool/local-development', - 'references/ts-sdk/typescript/owned-object-pool/custom-split-strategy', - 'references/ts-sdk/typescript/owned-object-pool/examples', - ], - }, - ], - }, - { - type: 'category', - label: 'dApp Kit', - items: [ - 'references/ts-sdk/dapp-kit/index', - 'references/ts-sdk/dapp-kit/create-dapp', - 'references/ts-sdk/dapp-kit/iota-client-provider', - 'references/ts-sdk/dapp-kit/rpc-hooks', - 'references/ts-sdk/dapp-kit/wallet-provider', - { - type: 'category', - label: 'Wallet Components', - items: [ - 'references/ts-sdk/dapp-kit/wallet-components/ConnectButton', - 'references/ts-sdk/dapp-kit/wallet-components/ConnectModal', - ], - }, - { - type: 'category', - label: 'Wallet Hooks', - items: [ - 'references/ts-sdk/dapp-kit/wallet-hooks/useWallets', - 'references/ts-sdk/dapp-kit/wallet-hooks/useAccounts', - 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount', - 'references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSignTransactionBlock', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransactionBlock', - ], - }, - 'references/ts-sdk/dapp-kit/themes', - ], - }, - { - type: 'category', - label: 'Kiosk SDK', - items: [ - 'references/ts-sdk/kiosk/index', - { - type: 'category', - label: 'Kiosk Client', - items: [ - 'references/ts-sdk/kiosk/kiosk-client/introduction', - 'references/ts-sdk/kiosk/kiosk-client/querying', - { - type: 'category', - label: 'Kiosk Transactions', - items: [ - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/kiosk-transaction', - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/managing', - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/purchasing', - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/examples', - ], - }, - { - type: 'category', - label: 'Transfer Policy Transactions', - items: [ - 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/introduction', - 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/using-the-manager', - ], - }, - ], - }, - 'references/ts-sdk/kiosk/advanced-examples', - 'references/ts-sdk/kiosk/from-v1', - ], - }, - 'references/ts-sdk/bcs', - { - type: 'category', - label: 'API', - link:{ - type: 'doc', - id: 'references/ts-sdk/api/index', - }, - items: typedocSidebar, - }, - - ], - }, - ], - }, + 'references/rust-sdk', { type: 'category', label: 'Move', - collapsed: false, link: { type: 'doc', id: 'references/iota-move', @@ -235,21 +89,15 @@ const references = [ }, { type: 'category', - label: 'Expert topics', + label: 'Execution Architecture', + link: { + type: 'doc', + id: 'references/execution-architecture/execution-layer', + }, items: [ - { - type: 'category', - label: 'Execution Architecture', - link: { - type: 'doc', - id: 'references/execution-architecture/execution-layer', - }, - items: [ - 'references/execution-architecture/iota-execution', - 'references/execution-architecture/adapter', - 'references/execution-architecture/natives', - ], - }, + 'references/execution-architecture/iota-execution', + 'references/execution-architecture/adapter', + 'references/execution-architecture/natives', ], }, 'references/research-papers', @@ -266,7 +114,7 @@ const references = [ 'references/contribute/code-of-conduct', 'references/contribute/style-guide', 'references/contribute/add-a-quiz', - 'references/contribute/import-code-docs' + 'references/contribute/import-code-docs', ], }, ]; diff --git a/docs/content/sidebars/ts-sdk.js b/docs/content/sidebars/ts-sdk.js new file mode 100644 index 00000000000..b4d55ed811f --- /dev/null +++ b/docs/content/sidebars/ts-sdk.js @@ -0,0 +1,133 @@ +// Copyright (c) Mysten Labs, Inc. +// Modifications Copyright (c) 2024 IOTA Stiftung +// SPDX-License-Identifier: Apache-2.0 + +import typedocSidebar from '../references/ts-sdk/api/typedoc-sidebar.cjs'; +const references = [ + { + type: 'category', + label: 'Typescript SDK', + items: [ + 'references/ts-sdk/typescript/index', + 'references/ts-sdk/typescript/install', + 'references/ts-sdk/typescript/hello-iota', + 'references/ts-sdk/typescript/faucet', + 'references/ts-sdk/typescript/iota-client', + { + type: 'category', + label: 'Transaction Building', + items: [ + 'references/ts-sdk/typescript/transaction-building/basics', + 'references/ts-sdk/typescript/transaction-building/gas', + 'references/ts-sdk/typescript/transaction-building/sponsored-transactions', + 'references/ts-sdk/typescript/transaction-building/offline', + ], + }, + { + type: 'category', + label: 'Cryptography', + items: [ + 'references/ts-sdk/typescript/cryptography/keypairs', + 'references/ts-sdk/typescript/cryptography/multisig', + ], + }, + 'references/ts-sdk/typescript/utils', + 'references/ts-sdk/typescript/bcs', + { + type: 'category', + label: 'Owned Object Pool', + items: [ + 'references/ts-sdk/typescript/owned-object-pool/index', + 'references/ts-sdk/typescript/owned-object-pool/overview', + 'references/ts-sdk/typescript/owned-object-pool/local-development', + 'references/ts-sdk/typescript/owned-object-pool/custom-split-strategy', + 'references/ts-sdk/typescript/owned-object-pool/examples', + ], + }, + ], + }, + { + type: 'category', + label: 'dApp Kit', + items: [ + 'references/ts-sdk/dapp-kit/index', + 'references/ts-sdk/dapp-kit/create-dapp', + 'references/ts-sdk/dapp-kit/iota-client-provider', + 'references/ts-sdk/dapp-kit/rpc-hooks', + 'references/ts-sdk/dapp-kit/wallet-provider', + { + type: 'category', + label: 'Wallet Components', + items: [ + 'references/ts-sdk/dapp-kit/wallet-components/ConnectButton', + 'references/ts-sdk/dapp-kit/wallet-components/ConnectModal', + ], + }, + { + type: 'category', + label: 'Wallet Hooks', + items: [ + 'references/ts-sdk/dapp-kit/wallet-hooks/useWallets', + 'references/ts-sdk/dapp-kit/wallet-hooks/useAccounts', + 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount', + 'references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSignTransactionBlock', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransactionBlock', + ], + }, + 'references/ts-sdk/dapp-kit/themes', + ], + }, + { + type: 'category', + label: 'Kiosk SDK', + items: [ + 'references/ts-sdk/kiosk/index', + { + type: 'category', + label: 'Kiosk Client', + items: [ + 'references/ts-sdk/kiosk/kiosk-client/introduction', + 'references/ts-sdk/kiosk/kiosk-client/querying', + { + type: 'category', + label: 'Kiosk Transactions', + items: [ + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/kiosk-transaction', + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/managing', + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/purchasing', + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/examples', + ], + }, + { + type: 'category', + label: 'Transfer Policy Transactions', + items: [ + 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/introduction', + 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/using-the-manager', + ], + }, + ], + }, + 'references/ts-sdk/kiosk/advanced-examples', + 'references/ts-sdk/kiosk/from-v1', + ], + }, + 'references/ts-sdk/bcs', + { + type: 'category', + label: 'API', + link: { + type: 'doc', + id: 'references/ts-sdk/api/index', + }, + items: typedocSidebar, + }, +]; + +module.exports = references; diff --git a/docs/site/src/pages/index.js b/docs/site/src/pages/index.js index ba011c0c546..eae3ddcc339 100644 --- a/docs/site/src/pages/index.js +++ b/docs/site/src/pages/index.js @@ -99,7 +99,7 @@ export default function Home() { Move From 49c9891a361150e2b81b84c851181387f34449d4 Mon Sep 17 00:00:00 2001 From: Lucas Tortora Date: Wed, 13 Nov 2024 21:22:27 -0300 Subject: [PATCH 2/7] add notes about CTF --- docs/content/developer/developer.mdx | 6 +++++- docs/content/developer/getting-started/getting-started.mdx | 7 ++++--- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/content/developer/developer.mdx b/docs/content/developer/developer.mdx index 93c9740fa32..f1e5c6c7ad6 100644 --- a/docs/content/developer/developer.mdx +++ b/docs/content/developer/developer.mdx @@ -28,7 +28,7 @@ Utilizing standards while developing applications is very important for composab Go to the [Standards](/developer/standards). -## IOTA compared to EVM +## IOTA Compared to EVM If you are familiar with EVM/Solidity and want to work with IOTA and Move this section is for you. These topics describe the differences between a traditional EVM chain and way of working compared to IOTA Move based smart contracts. Together with some common implementation examples the nuances between the different ways of working are explained. @@ -40,6 +40,10 @@ The Cryptography section demonstrates how to secure your smart contracts with cr Go to [Cryptography](cryptography.mdx). +## Capture the Flag + +Get aquainted with IOTA by solving challenges of increasing complexity in the [Capture the Flag section](iota-move-ctf/introduction.mdx). + ## Advanced Topics The Advanced Topics section includes guides for advanced solutions (like asset tokenization). These topics assume you are familiar with Move and the IOTA blockchain. diff --git a/docs/content/developer/getting-started/getting-started.mdx b/docs/content/developer/getting-started/getting-started.mdx index f7eef5dbd7c..fd5d3cc9e0f 100644 --- a/docs/content/developer/getting-started/getting-started.mdx +++ b/docs/content/developer/getting-started/getting-started.mdx @@ -28,10 +28,11 @@ If you are already familiar with the basics, you can try the following sections: - [Create a Move Package](create-a-package.mdx): Learn by writing, building, and publishing a simple dApp. - [IOTA 101](../iota-101.mdx): Get an overview of - the [Move concepts](../iota-101/move-overview/move-overview.mdx) you'll use as a foundation to - build [create coins, tokens](../iota-101/create-coin/create-coin.mdx) and [NFTs](../iota-101/nft/create-nft.mdx) using the - Move's [Object Model](../iota-101/objects/object-model.mdx). + the [Move concepts](../move-overview/move-overview.mdx) you'll use as a foundation to + build [create coins, tokens](../create-coin/create-coin.mdx) and [NFTs](../nft/create-nft.mdx) using the + Move's [Object Model](../objects/object-model.mdx). - [From Solidity/EVM to Move](../evm-to-move/evm-to-move.mdx): If you're an experienced Solidity developer, check out the key differences between developing on Move. +- Learn Move with the [IOTA Capture the Flag](../iota-move-ctf/introduction.mdx) challenges. - [Cryptography](../cryptography.mdx): Leverage multiple cryptographic algorithms to create secure and flexible smart contracts applications. \ No newline at end of file From 2086aba7e8ce98e9408db6e023609c9415a5b6a4 Mon Sep 17 00:00:00 2001 From: Lucas Tortora Date: Wed, 13 Nov 2024 22:25:17 -0300 Subject: [PATCH 3/7] feat(devx) reorganized navigation items to give the CLI and SDKs more visibility, and give the users a better overview of the developer section --- docs/content/developer/developer.mdx | 2 +- .../getting-started/getting-started.mdx | 8 +- docs/content/developer/guides.mdx | 61 ------- .../developer/{ => iota-101}/iota-101.mdx | 12 +- docs/content/references/iota-sdks.mdx | 2 +- docs/content/sidebars/developer.js | 169 +++++++++++------- docs/content/sidebars/references.js | 19 -- docs/site/docusaurus.config.js | 4 + docs/site/sidebars.js | 2 + 9 files changed, 121 insertions(+), 158 deletions(-) delete mode 100644 docs/content/developer/guides.mdx rename docs/content/developer/{ => iota-101}/iota-101.mdx (83%) diff --git a/docs/content/developer/developer.mdx b/docs/content/developer/developer.mdx index f1e5c6c7ad6..9fe0a348d29 100644 --- a/docs/content/developer/developer.mdx +++ b/docs/content/developer/developer.mdx @@ -20,7 +20,7 @@ The [Network Overview](network-overview.mdx) page gives an overview of the diffe The IOTA 101 section introduces the basics of IOTA that help you create smart contracts. These topics assume you are familiar with Move and the IOTA blockchain. -Go to [IOTA 101](iota-101.mdx). +Go to [IOTA 101](iota-101/iota-101.mdx). ## Standards diff --git a/docs/content/developer/getting-started/getting-started.mdx b/docs/content/developer/getting-started/getting-started.mdx index fd5d3cc9e0f..76a0fa944ef 100644 --- a/docs/content/developer/getting-started/getting-started.mdx +++ b/docs/content/developer/getting-started/getting-started.mdx @@ -27,10 +27,10 @@ Go to [Query IOTA RPC with GraphQL](graphql-rpc.mdx). If you are already familiar with the basics, you can try the following sections: - [Create a Move Package](create-a-package.mdx): Learn by writing, building, and publishing a simple dApp. -- [IOTA 101](../iota-101.mdx): Get an overview of - the [Move concepts](../move-overview/move-overview.mdx) you'll use as a foundation to - build [create coins, tokens](../create-coin/create-coin.mdx) and [NFTs](../nft/create-nft.mdx) using the - Move's [Object Model](../objects/object-model.mdx). +- [IOTA 101](../iota-101/iota-101.mdx): Get an overview of + the [Move concepts](../iota-101/move-overview/move-overview.mdx) you'll use as a foundation to + build [create coins, tokens](../iota-101/create-coin/create-coin.mdx) and [NFTs](../iota-101/nft/create-nft.mdx) using the + Move's [Object Model](../iota-101/objects/object-model.mdx). - [From Solidity/EVM to Move](../evm-to-move/evm-to-move.mdx): If you're an experienced Solidity developer, check out the key differences between developing on Move. - Learn Move with the [IOTA Capture the Flag](../iota-move-ctf/introduction.mdx) challenges. diff --git a/docs/content/developer/guides.mdx b/docs/content/developer/guides.mdx deleted file mode 100644 index e4b9f24759c..00000000000 --- a/docs/content/developer/guides.mdx +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: Guides Overview -sidebar_label: Overview ---- - -Often, the best way to learn a new technology is through experience. The content in this section contains concrete examples to guide your development on the IOTA network. Whether you're a web3 novice or a seasoned IOTA pro, the guides in this section help you get the most out of your IOTA development experience. - -## Guides by role - -Instructions for common tasks, based on your role in the IOTA ecosystem. - - -Guides for developers of all levels. - - -Guides for validators and node operators. - - - -## Get started developing on IOTA - -You must crawl before you can run. Start your IOTA journey here. - - -Learn about IOTA tools and the recommended development environment. - - -Install IOTA on your Windows, MacOS, or Linux system. - - -With IOTA installed, you're ready to start developing. - - - -## IOTA 101 for developers - -Learn the basics of IOTA and how they might differ from other blockchains. - - -Transactions on IOTA are more powerful than other blockchains. Learn why and how to use them. - - - - -Monitor the IOTA network and programmatically react to on-chain events. - - - -## Validating and operating nodes on IOTA - -Processes and guides for validators and node operators on the IOTA network. - - - - -Learn how to operate a Full node on IOTA. - - -Optimize your Full node configuration for efficient node operation. - - diff --git a/docs/content/developer/iota-101.mdx b/docs/content/developer/iota-101/iota-101.mdx similarity index 83% rename from docs/content/developer/iota-101.mdx rename to docs/content/developer/iota-101/iota-101.mdx index 00ae371b7da..faa3df86502 100644 --- a/docs/content/developer/iota-101.mdx +++ b/docs/content/developer/iota-101/iota-101.mdx @@ -9,29 +9,29 @@ In many education systems, 101-level classes are those that teach core competenc Everything on the IOTA blockchain is an object. These topics use code examples to demonstrate how to create these specific types of objects. -- [Create Coins](iota-101/create-coin/create-coin.mdx) -- [Create NFTs](iota-101/nft/create-nft.mdx) +- [Create Coins](create-coin/create-coin.mdx) +- [Create NFTs](nft/create-nft.mdx) ## Working with PTBs You can create programmable transaction blocks (PTBs) on IOTA to perform multiple commands in a single transaction. The Working with PTBs topics demonstrate how to build efficient PTBs using the IOTA TypeScript SDK. -Go to [Working with PTBs](iota-101/transactions/ptb/programmable-transaction-blocks-overview). +Go to [Working with PTBs](transactions/ptb/programmable-transaction-blocks-overview). ## Using Events You can emit events from your published packages on the IOTA network. Using Events demonstrates how to emit events from your on-chain packages and monitor the activity of other objects emitting events. -Go to [Using Events](iota-101/using-events.mdx). +Go to [Using Events](using-events.mdx). ## Shared versus Owned Objects Objects on IOTA, unlike other blockchains, can be owned as well as shared. You can create transactions that leverage either type or both. Shared versus Owned Objects examines the differences and what considerations you should account for when deciding how to structure your on-chain app. -Go to [Shared versus Owned Objects](iota-101/objects/shared-owned.mdx). +Go to [Shared versus Owned Objects](objects/shared-owned.mdx). ## Access On-Chain Time IOTA provides a `Clock` module you can use to get network-based time. Access On-Chain Time examines the `Clock` module and the behavior of the available methods that affect transaction processing speed and the temporal exactness of the data you receive. -Go to [Access On-Chain Time](iota-101/access-time.mdx). \ No newline at end of file +Go to [Access On-Chain Time](access-time.mdx). \ No newline at end of file diff --git a/docs/content/references/iota-sdks.mdx b/docs/content/references/iota-sdks.mdx index 840ea0e7346..1189cf6b9a2 100644 --- a/docs/content/references/iota-sdks.mdx +++ b/docs/content/references/iota-sdks.mdx @@ -14,7 +14,7 @@ See [Rust SDK](./rust-sdk.mdx) for SDK configuration and examples of using the I ## IOTA TypeScript SDK -The IOTA TypeScript SDK documentation is available in its own microsite: [IOTA Typescript SDK](ts-sdk/typescript/index.mdx). +The IOTA TypeScript SDK documentation is available in the [IOTA Typescript SDK section](ts-sdk/typescript/index.mdx). ### Crate documentation diff --git a/docs/content/sidebars/developer.js b/docs/content/sidebars/developer.js index d97cad27c59..9d207ad97f2 100644 --- a/docs/content/sidebars/developer.js +++ b/docs/content/sidebars/developer.js @@ -20,7 +20,6 @@ const developer = [ 'developer/getting-started/local-network', 'developer/getting-started/get-address', 'developer/getting-started/get-coins', - 'developer/getting-started/graphql-rpc', 'developer/getting-started/create-a-package', 'developer/getting-started/create-a-module', 'developer/getting-started/build-test', @@ -30,101 +29,130 @@ const developer = [ 'developer/getting-started/coffee-example', ], }, + { + type: 'category', + label: 'SDKs & CLI', + items: [ + { + type: 'category', + label: 'IOTA CLI', + link: { + type: 'doc', + id: 'references/cli', + }, + items: [ + 'references/cli/client', + 'references/cli/ptb', + 'references/cli/console', + 'references/cli/keytool', + 'references/cli/move', + 'references/cli/validator', + 'references/cli/ceremony', + 'references/cli/cheatsheet', + ], + }, + 'references/rust-sdk', + { + type: 'link', + label: 'Typescript SDK', + href: '/references/ts-sdk/typescript', + }, + ], + }, { type: 'category', label: 'Move Overview', items: [ - 'developer/move-overview/move-overview', - 'developer/move-overview/strings', - 'developer/move-overview/collections', - 'developer/move-overview/init', - 'developer/move-overview/visibility', - 'developer/move-overview/entry-functions', + 'developer/iota-101/move-overview/move-overview', + 'developer/iota-101/move-overview/strings', + 'developer/iota-101/move-overview/collections', + 'developer/iota-101/move-overview/init', + 'developer/iota-101/move-overview/visibility', + 'developer/iota-101/move-overview/entry-functions', { type: 'category', label: 'Structs and Abilities', items: [ - 'developer/move-overview/structs-and-abilities/struct', - 'developer/move-overview/structs-and-abilities/copy', - 'developer/move-overview/structs-and-abilities/drop', - 'developer/move-overview/structs-and-abilities/key', - 'developer/move-overview/structs-and-abilities/store', + 'developer/iota-101/move-overview/structs-and-abilities/struct', + 'developer/iota-101/move-overview/structs-and-abilities/copy', + 'developer/iota-101/move-overview/structs-and-abilities/drop', + 'developer/iota-101/move-overview/structs-and-abilities/key', + 'developer/iota-101/move-overview/structs-and-abilities/store', ], }, - 'developer/move-overview/one-time-witness', + 'developer/iota-101/move-overview/one-time-witness', { type: 'category', label: 'Package Upgrades', items: [ - 'developer/move-overview/package-upgrades/introduction', - 'developer/move-overview/package-upgrades/upgrade', - 'developer/move-overview/package-upgrades/automated-address-management', - 'developer/move-overview/package-upgrades/custom-policies', + 'developer/iota-101/move-overview/package-upgrades/introduction', + 'developer/iota-101/move-overview/package-upgrades/upgrade', + 'developer/iota-101/move-overview/package-upgrades/automated-address-management', + 'developer/iota-101/move-overview/package-upgrades/custom-policies', ], }, - 'developer/move-overview/ownership-scope', - 'developer/move-overview/references', - 'developer/move-overview/generics', + 'developer/iota-101/move-overview/ownership-scope', + 'developer/iota-101/move-overview/references', + 'developer/iota-101/move-overview/generics', { type: 'category', label: 'Patterns', items: [ - 'developer/move-overview/patterns/patterns', - 'developer/move-overview/patterns/capabilities', - 'developer/move-overview/patterns/witness', - 'developer/move-overview/patterns/transferable-witness', - 'developer/move-overview/patterns/hot-potato', - 'developer/move-overview/patterns/id-pointer', + 'developer/iota-101/move-overview/patterns/patterns', + 'developer/iota-101/move-overview/patterns/capabilities', + 'developer/iota-101/move-overview/patterns/witness', + 'developer/iota-101/move-overview/patterns/transferable-witness', + 'developer/iota-101/move-overview/patterns/hot-potato', + 'developer/iota-101/move-overview/patterns/id-pointer', ], }, - 'developer/move-overview/conventions', + 'developer/iota-101/move-overview/conventions', ], }, - 'developer/graphql-rpc', { type: 'category', label: 'Object Model', items: [ - 'developer/objects/object-model', - 'developer/objects/shared-owned', + 'developer/iota-101/objects/object-model', + 'developer/iota-101/objects/shared-owned', { type: 'category', label: 'Object Ownership', link: { type: 'doc', - id: 'developer/objects/object-ownership/object-ownership', + id: 'developer/iota-101/objects/object-ownership/object-ownership', }, items: [ - 'developer/objects/object-ownership/address-owned', - 'developer/objects/object-ownership/immutable', - 'developer/objects/object-ownership/shared', - 'developer/objects/object-ownership/wrapped', + 'developer/iota-101/objects/object-ownership/address-owned', + 'developer/iota-101/objects/object-ownership/immutable', + 'developer/iota-101/objects/object-ownership/shared', + 'developer/iota-101/objects/object-ownership/wrapped', ], }, - 'developer/objects/uid-id', + 'developer/iota-101/objects/uid-id', { type: 'category', label: 'Dynamic Fields', link: { type: 'doc', - id: 'developer/objects/dynamic-fields/dynamic-fields', + id: 'developer/iota-101/objects/dynamic-fields/dynamic-fields', }, - items: ['developer/objects/dynamic-fields/tables-bags'], + items: ['developer/iota-101/objects/dynamic-fields/tables-bags'], }, { type: 'category', label: 'Transfers', link: { type: 'doc', - id: 'developer/objects/transfers/transfers', + id: 'developer/iota-101/objects/transfers/transfers', }, items: [ - 'developer/objects/transfers/custom-rules', - 'developer/objects/transfers/transfer-to-object', + 'developer/iota-101/objects/transfers/custom-rules', + 'developer/iota-101/objects/transfers/transfer-to-object', ], }, - 'developer/objects/events', - 'developer/objects/versioning', + 'developer/iota-101/objects/events', + 'developer/iota-101/objects/versioning', ], }, { @@ -132,35 +160,35 @@ const developer = [ label: 'Transactions', link: { type: 'doc', - id: 'developer/transactions/transactions', + id: 'developer/iota-101/transactions/transactions', }, items: [ - 'developer/transactions/sign-and-send-transactions', + 'developer/iota-101/transactions/sign-and-send-transactions', { type: 'category', label: 'Sponsored Transactions', link: { type: 'doc', - id: 'developer/transactions/sponsored-transactions/about-sponsored-transactions', + id: 'developer/iota-101/transactions/sponsored-transactions/about-sponsored-transactions', }, items: [ - 'developer/transactions/sponsored-transactions/about-sponsored-transactions', - 'developer/transactions/sponsored-transactions/use-sponsored-transactions'], + 'developer/iota-101/transactions/sponsored-transactions/about-sponsored-transactions', + 'developer/iota-101/transactions/sponsored-transactions/use-sponsored-transactions', + ], }, { type: 'category', label: 'Working with PTBs', link: { type: 'doc', - id:'developer/transactions/ptb/programmable-transaction-blocks-overview', + id: 'developer/iota-101/transactions/ptb/programmable-transaction-blocks-overview', }, items: [ - 'developer/transactions/ptb/programmable-transaction-blocks', - 'developer/transactions/ptb/building-programmable-transaction-blocks-ts-sdk', - 'developer/transactions/ptb/simulating-references', - 'developer/transactions/ptb/coin-management', - 'developer/transactions/ptb/optimizing-gas-with-coin-merging', - + 'developer/iota-101/transactions/ptb/programmable-transaction-blocks', + 'developer/iota-101/transactions/ptb/building-programmable-transaction-blocks-ts-sdk', + 'developer/iota-101/transactions/ptb/simulating-references', + 'developer/iota-101/transactions/ptb/coin-management', + 'developer/iota-101/transactions/ptb/optimizing-gas-with-coin-merging', ], }, ], @@ -170,22 +198,22 @@ const developer = [ label: 'Create Coins and Tokens', link: { type: 'doc', - id: 'developer/create-coin/create-coin', + id: 'developer/iota-101/create-coin/create-coin', }, items: [ - 'developer/create-coin/regulated', - 'developer/create-coin/migrate-to-coin-manager', - 'developer/create-coin/in-game-token', - 'developer/create-coin/loyalty', + 'developer/iota-101/create-coin/regulated', + 'developer/iota-101/create-coin/migrate-to-coin-manager', + 'developer/iota-101/create-coin/in-game-token', + 'developer/iota-101/create-coin/loyalty', ], }, { type: 'category', label: 'NFT', - items: ['developer/nft/create-nft', 'developer/nft/rent-nft'], + items: ['developer/iota-101/nft/create-nft', 'developer/iota-101/nft/rent-nft'], }, - 'developer/using-events', - 'developer/access-time', + 'developer/iota-101/using-events', + 'developer/iota-101/access-time', { type: 'category', label: 'Cryptography', @@ -231,8 +259,9 @@ const developer = [ label: 'Standards', link: { type: 'generated-index', - title:'IOTA Standards Overview', - description: 'Standards on the IOTA blockchain are features, frameworks, or apps that you can extend or customize.', + title: 'IOTA Standards Overview', + description: + 'Standards on the IOTA blockchain are features, frameworks, or apps that you can extend or customize.', slug: 'developer/standards', }, items: [ @@ -291,6 +320,15 @@ const developer = [ 'developer/evm-to-move/creating-nft', ], }, + { + type: 'category', + label: 'GraphQL', + items: [ + 'developer/getting-started/graphql-rpc', + 'developer/graphql-rpc', + 'developer/advanced/graphql-migration', + ], + }, { type: 'category', label: 'Advanced Topics', @@ -302,7 +340,6 @@ const developer = [ 'developer/advanced/introducing-move-2024', 'developer/advanced/iota-repository', 'developer/advanced/custom-indexer', - 'developer/advanced/graphql-migration', 'developer/advanced/onchain-randomness', 'developer/advanced/asset-tokenization', ], diff --git a/docs/content/sidebars/references.js b/docs/content/sidebars/references.js index 7c27953d5aa..2b4673f258f 100644 --- a/docs/content/sidebars/references.js +++ b/docs/content/sidebars/references.js @@ -39,25 +39,6 @@ const references = [ 'references/iota-api/rpc-best-practices', ], }, - { - type: 'category', - label: 'IOTA CLI', - link: { - type: 'doc', - id: 'references/cli', - }, - items: [ - 'references/cli/client', - 'references/cli/ptb', - 'references/cli/console', - 'references/cli/keytool', - 'references/cli/move', - 'references/cli/validator', - 'references/cli/ceremony', - 'references/cli/cheatsheet', - ], - }, - 'references/rust-sdk', { type: 'category', label: 'Move', diff --git a/docs/site/docusaurus.config.js b/docs/site/docusaurus.config.js index a789f2b0a80..bf3b48955b3 100644 --- a/docs/site/docusaurus.config.js +++ b/docs/site/docusaurus.config.js @@ -240,6 +240,10 @@ const config = { label: "Developers", to: "developer", }, + { + label: "TS SDK", + to: "references/ts-sdk/typescript/", + }, { label: "Node Operators", to: "operator", diff --git a/docs/site/sidebars.js b/docs/site/sidebars.js index 1fd99ac962c..0207505a354 100644 --- a/docs/site/sidebars.js +++ b/docs/site/sidebars.js @@ -7,6 +7,7 @@ const developer = require("../content/sidebars/developer.js"); const aboutIota = require("../content/sidebars/about-iota.js"); const operator = require("../content/sidebars/operator.js"); const references = require("../content/sidebars/references.js"); +const tsSDK = require("../content/sidebars/ts-sdk.js") const sidebars = { //whyIOTASidebar: why_iota, @@ -14,6 +15,7 @@ const sidebars = { operatorSidebar: operator, aboutIotaSidebar: aboutIota, referencesSidebar: references, + tsSDK: tsSDK, }; module.exports = sidebars; From 2d457d57933a2a95a72a3fc48150e5d50c4a2830 Mon Sep 17 00:00:00 2001 From: Lucas Tortora Date: Wed, 13 Nov 2024 22:40:18 -0300 Subject: [PATCH 4/7] fix link --- docs/site/src/pages/index.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/site/src/pages/index.js b/docs/site/src/pages/index.js index eae3ddcc339..ec625cceb43 100644 --- a/docs/site/src/pages/index.js +++ b/docs/site/src/pages/index.js @@ -99,7 +99,7 @@ export default function Home() { Move From 223e0404f1dc2130ddb769182f91950b51d5db2d Mon Sep 17 00:00:00 2001 From: Lucas Tortora Date: Thu, 14 Nov 2024 06:59:59 -0300 Subject: [PATCH 5/7] fix link --- docs/site/src/pages/index.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/site/src/pages/index.js b/docs/site/src/pages/index.js index ec625cceb43..7cfe41a3912 100644 --- a/docs/site/src/pages/index.js +++ b/docs/site/src/pages/index.js @@ -99,7 +99,7 @@ export default function Home() { Move From 4bec3792dbdf7e85cfbe2b2b284de16be58f4b47 Mon Sep 17 00:00:00 2001 From: Lucas Tortora Date: Thu, 14 Nov 2024 12:05:43 -0300 Subject: [PATCH 6/7] fix sidebar order --- docs/content/sidebars/developer.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/content/sidebars/developer.js b/docs/content/sidebars/developer.js index 9d207ad97f2..476f9e4e2e3 100644 --- a/docs/content/sidebars/developer.js +++ b/docs/content/sidebars/developer.js @@ -57,6 +57,7 @@ const developer = [ label: 'Typescript SDK', href: '/references/ts-sdk/typescript', }, + 'developer/iota-101/using-events', ], }, { @@ -106,6 +107,7 @@ const developer = [ 'developer/iota-101/move-overview/patterns/id-pointer', ], }, + 'developer/iota-101/access-time', 'developer/iota-101/move-overview/conventions', ], }, @@ -212,8 +214,6 @@ const developer = [ label: 'NFT', items: ['developer/iota-101/nft/create-nft', 'developer/iota-101/nft/rent-nft'], }, - 'developer/iota-101/using-events', - 'developer/iota-101/access-time', { type: 'category', label: 'Cryptography', From d254b7fd530bd4881aeda9dbf19bd7305c14cb98 Mon Sep 17 00:00:00 2001 From: Lucas Tortora Date: Fri, 15 Nov 2024 13:30:20 -0300 Subject: [PATCH 7/7] update from develop --- docs/content/sidebars/ts-sdk.js | 197 +++++++++++++++++--------------- 1 file changed, 108 insertions(+), 89 deletions(-) diff --git a/docs/content/sidebars/ts-sdk.js b/docs/content/sidebars/ts-sdk.js index b4d55ed811f..0db6843655c 100644 --- a/docs/content/sidebars/ts-sdk.js +++ b/docs/content/sidebars/ts-sdk.js @@ -6,116 +6,135 @@ import typedocSidebar from '../references/ts-sdk/api/typedoc-sidebar.cjs'; const references = [ { type: 'category', - label: 'Typescript SDK', + label: 'IOTA TypeScript Documentation', items: [ - 'references/ts-sdk/typescript/index', - 'references/ts-sdk/typescript/install', - 'references/ts-sdk/typescript/hello-iota', - 'references/ts-sdk/typescript/faucet', - 'references/ts-sdk/typescript/iota-client', { type: 'category', - label: 'Transaction Building', + label: 'Typescript SDK', items: [ - 'references/ts-sdk/typescript/transaction-building/basics', - 'references/ts-sdk/typescript/transaction-building/gas', - 'references/ts-sdk/typescript/transaction-building/sponsored-transactions', - 'references/ts-sdk/typescript/transaction-building/offline', - ], - }, - { - type: 'category', - label: 'Cryptography', - items: [ - 'references/ts-sdk/typescript/cryptography/keypairs', - 'references/ts-sdk/typescript/cryptography/multisig', - ], - }, - 'references/ts-sdk/typescript/utils', - 'references/ts-sdk/typescript/bcs', - { - type: 'category', - label: 'Owned Object Pool', - items: [ - 'references/ts-sdk/typescript/owned-object-pool/index', - 'references/ts-sdk/typescript/owned-object-pool/overview', - 'references/ts-sdk/typescript/owned-object-pool/local-development', - 'references/ts-sdk/typescript/owned-object-pool/custom-split-strategy', - 'references/ts-sdk/typescript/owned-object-pool/examples', - ], - }, - ], - }, - { - type: 'category', - label: 'dApp Kit', - items: [ - 'references/ts-sdk/dapp-kit/index', - 'references/ts-sdk/dapp-kit/create-dapp', - 'references/ts-sdk/dapp-kit/iota-client-provider', - 'references/ts-sdk/dapp-kit/rpc-hooks', - 'references/ts-sdk/dapp-kit/wallet-provider', - { - type: 'category', - label: 'Wallet Components', - items: [ - 'references/ts-sdk/dapp-kit/wallet-components/ConnectButton', - 'references/ts-sdk/dapp-kit/wallet-components/ConnectModal', - ], - }, - { - type: 'category', - label: 'Wallet Hooks', - items: [ - 'references/ts-sdk/dapp-kit/wallet-hooks/useWallets', - 'references/ts-sdk/dapp-kit/wallet-hooks/useAccounts', - 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount', - 'references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSignTransactionBlock', - 'references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransactionBlock', + 'references/ts-sdk/typescript/index', + 'references/ts-sdk/typescript/install', + 'references/ts-sdk/typescript/hello-iota', + 'references/ts-sdk/typescript/faucet', + 'references/ts-sdk/typescript/iota-client', + 'references/ts-sdk/typescript/graphql', + { + type: 'category', + label: 'Transaction Building', + items: [ + 'references/ts-sdk/typescript/transaction-building/basics', + 'references/ts-sdk/typescript/transaction-building/gas', + 'references/ts-sdk/typescript/transaction-building/sponsored-transactions', + 'references/ts-sdk/typescript/transaction-building/offline', + ], + }, + { + type: 'category', + label: 'Cryptography', + items: [ + 'references/ts-sdk/typescript/cryptography/keypairs', + 'references/ts-sdk/typescript/cryptography/multisig', + ], + }, + 'references/ts-sdk/typescript/utils', + 'references/ts-sdk/typescript/bcs', + 'references/ts-sdk/typescript/executors', + 'references/ts-sdk/typescript/plugins', + { + type: 'category', + label: 'Owned Object Pool', + items: [ + 'references/ts-sdk/typescript/owned-object-pool/index', + 'references/ts-sdk/typescript/owned-object-pool/overview', + 'references/ts-sdk/typescript/owned-object-pool/local-development', + 'references/ts-sdk/typescript/owned-object-pool/custom-split-strategy', + 'references/ts-sdk/typescript/owned-object-pool/examples', + ], + }, ], }, - 'references/ts-sdk/dapp-kit/themes', - ], - }, - { - type: 'category', - label: 'Kiosk SDK', - items: [ - 'references/ts-sdk/kiosk/index', { type: 'category', - label: 'Kiosk Client', + label: 'dApp Kit', items: [ - 'references/ts-sdk/kiosk/kiosk-client/introduction', - 'references/ts-sdk/kiosk/kiosk-client/querying', + 'references/ts-sdk/dapp-kit/index', + 'references/ts-sdk/dapp-kit/create-dapp', + 'references/ts-sdk/dapp-kit/iota-client-provider', + 'references/ts-sdk/dapp-kit/rpc-hooks', + 'references/ts-sdk/dapp-kit/wallet-provider', { type: 'category', - label: 'Kiosk Transactions', + label: 'Wallet Components', items: [ - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/kiosk-transaction', - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/managing', - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/purchasing', - 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/examples', + 'references/ts-sdk/dapp-kit/wallet-components/ConnectButton', + 'references/ts-sdk/dapp-kit/wallet-components/ConnectModal', ], }, { type: 'category', - label: 'Transfer Policy Transactions', + label: 'Wallet Hooks', + items: [ + 'references/ts-sdk/dapp-kit/wallet-hooks/useWallets', + 'references/ts-sdk/dapp-kit/wallet-hooks/useAccounts', + 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useCurrentAccount', + 'references/ts-sdk/dapp-kit/wallet-hooks/useAutoConnectWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useConnectWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useDisconnectWallet', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSwitchAccount', + 'references/ts-sdk/dapp-kit/wallet-hooks/useReportTransactionEffects', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSignPersonalMessage', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSignTransaction', + 'references/ts-sdk/dapp-kit/wallet-hooks/useSignAndExecuteTransaction', + ], + }, + 'references/ts-sdk/dapp-kit/themes', + ], + }, + { + type: 'category', + label: 'Kiosk SDK', + items: [ + 'references/ts-sdk/kiosk/index', + { + type: 'category', + label: 'Kiosk Client', items: [ - 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/introduction', - 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/using-the-manager', + 'references/ts-sdk/kiosk/kiosk-client/introduction', + 'references/ts-sdk/kiosk/kiosk-client/querying', + { + type: 'category', + label: 'Kiosk Transactions', + items: [ + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/kiosk-transaction', + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/managing', + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/purchasing', + 'references/ts-sdk/kiosk/kiosk-client/kiosk-transaction/examples', + ], + }, + { + type: 'category', + label: 'Transfer Policy Transactions', + items: [ + 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/introduction', + 'references/ts-sdk/kiosk/kiosk-client/transfer-policy-transaction/using-the-manager', + ], + }, ], }, + 'references/ts-sdk/kiosk/advanced-examples', ], }, - 'references/ts-sdk/kiosk/advanced-examples', - 'references/ts-sdk/kiosk/from-v1', + 'references/ts-sdk/bcs', + { + type: 'category', + label: 'API', + link: { + type: 'doc', + id: 'references/ts-sdk/api/index', + }, + items: typedocSidebar, + }, ], }, 'references/ts-sdk/bcs',