Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feat/update docs #282

Merged
merged 77 commits into from
Dec 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
77 commits
Select commit Hold shift + click to select a range
4562eca
Changed layout of side navigation according to ticket ink-588
alexanderbradshaw Dec 10, 2024
4562a1f
Merge pull request #6 from eitjuh/feature/ink-588-menu-nested-changes
eitjuh Dec 11, 2024
2a2dc73
Updated oracles to be under tools
alexanderbradshaw Dec 11, 2024
be8933d
docs: add minimum requirements
eitjuh Dec 6, 2024
bc92022
Update about.mdx
InkP1 Dec 9, 2024
d90d4d6
fix: background body color
dkrabdev Dec 9, 2024
59f1541
Update about.mdx
InkP1 Dec 9, 2024
92fadbe
fix: disable spellcheck
eitjuh Dec 9, 2024
4fad8c9
fix: typo
eitjuh Dec 9, 2024
e766ec2
chore(deps): bump next from 15.0.3 to 15.0.4 (#266)
dependabot[bot] Dec 9, 2024
7295bf8
chore(deps): bump next-themes from 0.4.3 to 0.4.4 (#270)
dependabot[bot] Dec 9, 2024
93c3414
chore(deps-dev): bump tailwindcss from 3.4.15 to 3.4.16 (#267)
dependabot[bot] Dec 9, 2024
3d54ced
chore(deps-dev): bump prettier from 3.4.1 to 3.4.2 (#268)
dependabot[bot] Dec 9, 2024
d081b83
chore(deps-dev): bump eslint-config-next from 15.0.3 to 15.0.4 (#269)
dependabot[bot] Dec 9, 2024
183b1ea
fix: ws urls
eitjuh Dec 12, 2024
e53f1a1
Changed layout of side navigation according to ticket ink-588
alexanderbradshaw Dec 10, 2024
d2fee6f
chore(deps-dev): bump eslint-config-next from 15.0.4 to 15.1.0
dependabot[bot] Dec 12, 2024
ebb4499
chore(deps): bump next from 15.0.4 to 15.1.0
dependabot[bot] Dec 12, 2024
d0d6bb4
fix: oracles merge conflict
eitjuh Dec 12, 2024
02994cb
Merge pull request #7 from eitjuh/dependabot/npm_and_yarn/eslint-conf…
ink-victor Dec 13, 2024
9a57955
Merge pull request #8 from eitjuh/dependabot/npm_and_yarn/next-15.1.0
ink-victor Dec 13, 2024
922c076
feat: update docs content
ink-victor Dec 13, 2024
f670950
fix favicon
ink-victor Dec 13, 2024
e85599b
Merge pull request #9 from eitjuh/feat/update-docs-content
eitjuh Dec 13, 2024
6855392
chore(deps-dev): bump @types/node from 22.10.1 to 22.10.2
dependabot[bot] Dec 16, 2024
728b483
chore(deps-dev): bump cspell from 8.16.1 to 8.17.0
dependabot[bot] Dec 16, 2024
dd89018
feat: amend add ink network button
ink-victor Dec 16, 2024
76115a6
Update indexers.mdx
InkP1 Dec 17, 2024
ef46d59
Update account-abstraction.mdx
InkP1 Dec 17, 2024
24955c0
Update rpc.mdx
InkP1 Dec 17, 2024
505d431
Update network-information.mdx
InkP1 Dec 17, 2024
e99baae
Update connect-wallet.mdx
InkP1 Dec 17, 2024
a69712c
Update bridges.mdx
InkP1 Dec 17, 2024
f4fa36b
Update block-explorers.mdx
InkP1 Dec 17, 2024
c6b36f9
Update oracles.mdx
InkP1 Dec 17, 2024
67562b5
Merge pull request #10 from eitjuh/dependabot/npm_and_yarn/types/node…
ink-victor Dec 17, 2024
2588362
Merge pull request #11 from eitjuh/dependabot/npm_and_yarn/cspell-8.17.0
ink-victor Dec 17, 2024
a4b1290
Merge pull request #12 from eitjuh/feat/amend-add-ink-network-button
ink-victor Dec 17, 2024
d23a04c
Update faucets-content.mdx
InkP1 Dec 17, 2024
38c4806
Update indexers.mdx
InkP1 Dec 17, 2024
081efc8
Update oracles.mdx
InkP1 Dec 17, 2024
86f4337
Update rpc.mdx
InkP1 Dec 17, 2024
d2775b7
Update security.mdx
InkP1 Dec 17, 2024
f4a1b18
Update vrf.mdx
InkP1 Dec 17, 2024
f6f20a8
Update ink-token-contracts.mdx
InkP1 Dec 17, 2024
7345ade
Removed Chain Security section
alexanderbradshaw Dec 17, 2024
b77acec
Merge remote-tracking branch 'refs/remotes/origin/main'
alexanderbradshaw Dec 17, 2024
e6820f5
Update account-abstraction.mdx
InkP1 Dec 17, 2024
81c52c2
Update about.mdx
InkP1 Dec 18, 2024
1999539
Update connect-wallet.mdx
InkP1 Dec 18, 2024
0e835f9
Update bridges.mdx
InkP1 Dec 18, 2024
73ced8a
Update getting-started.mdx
InkP1 Dec 18, 2024
9ca7b22
Update getting-started.mdx
InkP1 Dec 18, 2024
07ca3b6
fix: fix callout error on ink token contracts
eitjuh Dec 18, 2024
0745114
chore(deps-dev): bump cspell from 8.16.1 to 8.17.1 (#281)
dependabot[bot] Dec 17, 2024
dc618de
Changed layout of side navigation according to ticket ink-588
alexanderbradshaw Dec 10, 2024
13c1061
Update about.mdx
InkP1 Dec 9, 2024
a388526
Update contributing.mdx
InkP1 Dec 18, 2024
fbf9544
Update ink-token-contracts.mdx
InkP1 Dec 18, 2024
cdb43df
Update faq.mdx
InkP1 Dec 18, 2024
6cb0c50
fix some broken links
eitjuh Dec 18, 2024
d9ca16e
fix mainnet network rpc
eitjuh Dec 18, 2024
da8009c
Update bridges.mdx
InkP1 Dec 18, 2024
186e3ee
Update faucets-content.mdx
InkP1 Dec 18, 2024
069a4e7
Update rpc.mdx
InkP1 Dec 18, 2024
3f5af10
Update bridges.mdx
InkP1 Dec 18, 2024
49b77ba
Update multisig-content.mdx
InkP1 Dec 18, 2024
cb509f1
Update rpc.mdx
InkP1 Dec 18, 2024
ae7d8a5
Update contracts.mdx
InkP1 Dec 18, 2024
e2dbfcb
Update bridges.mdx
InkP1 Dec 18, 2024
8f32201
Update rpc.mdx
InkP1 Dec 18, 2024
8c880cf
Update oracles.mdx
InkP1 Dec 18, 2024
f9e1969
Update bridges.mdx
InkP1 Dec 18, 2024
2d8d7dc
fix: fix connect network buttons
eitjuh Dec 18, 2024
801de52
fix ci
ink-victor Dec 18, 2024
3f30e64
Merge pull request #13 from eitjuh/fix/fix-connect-network-buttons
ink-victor Dec 18, 2024
98fe480
Merge remote-tracking branch 'upstream/main'
ink-victor Dec 18, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion next-env.d.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@
/// <reference types="next/image-types/global" />

// NOTE: This file should not be edited
// see https://nextjs.org/docs/pages/building-your-application/configuring/typescript for more information.
// see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.
30 changes: 16 additions & 14 deletions src/components/AddNetworkButton.tsx
Original file line number Diff line number Diff line change
@@ -1,17 +1,21 @@
import { useEffect, useState } from "react";

import { isInkSepoliaNetwork, switchToInkSepolia } from "@/utils/add-network";
import { addNetwork, isNetworkAdded, NetworkType } from "@/utils/add-network";

import { Button } from "./Button";

export const AddNetworkButton = () => {
const [isConnected, setIsConnected] = useState<boolean>(false);
interface AddNetworkButtonProps {
network: NetworkType;
}

export const AddNetworkButton = ({ network }: AddNetworkButtonProps) => {
const [isAdded, setIsAdded] = useState<boolean>(false);

useEffect(() => {
const checkNetwork = async () => {
if ((window as any).ethereum) {
const connected = await isInkSepoliaNetwork();
setIsConnected(connected);
const added = await isNetworkAdded(network);
setIsAdded(added);
}
};

Expand All @@ -26,11 +30,13 @@ export const AddNetworkButton = () => {
(window as any).ethereum.removeListener("chainChanged", checkNetwork);
}
};
}, []);
}, [network]);

const networkName = network === "mainnet" ? "Ink Mainnet" : "Ink Sepolia";

return (
<div className="space-y-2 mt-4">
{isConnected ? (
{isAdded ? (
<div className="flex items-center text-green-600 dark:text-green-400 font-semibold">
<svg
className="w-5 h-5 mr-2"
Expand All @@ -45,17 +51,13 @@ export const AddNetworkButton = () => {
d="M5 13l4 4L19 7"
/>
</svg>
Successfully connected to Ink Sepolia
{networkName} Network Added
</div>
) : (
<div className="space-y-4">
<Button variant="primary" onClick={switchToInkSepolia}>
Add Ink Sepolia Network
<Button variant="primary" onClick={() => addNetwork(network)}>
Add {networkName} Network
</Button>
<div className="text-sm text-gray-600 dark:text-gray-400 italic">
Note: Automatic network addition may not work with all wallets. See
manual instructions below if needed.
</div>
</div>
)}
</div>
Expand Down
2 changes: 1 addition & 1 deletion src/components/Head.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ export const Head = () => {
<meta property="twitter:creator" content="@inkonchain" />

{/* Favicon */}
<link rel="icon" href="img/icons/favicon.ico" type="image/x-icon" />
<link rel="icon" href="/img/icons/favicon.ico" type="image/x-icon" />
</>
);
};
11 changes: 11 additions & 0 deletions src/components/TestnetDisclaimer.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
import { Callout } from "nextra/components";

export const TestnetDisclaimer = () => {
return (
<Callout type="info" emoji="ℹ️">
This guide currently references Ink Sepolia (testnet) however it can be
used for Ink mainnet as well. Please be sure to change the necessary
parameters based on your network of choice.
</Callout>
);
};
35 changes: 11 additions & 24 deletions src/content/shared/faucets-content.mdx
Original file line number Diff line number Diff line change
@@ -1,32 +1,19 @@
## Faucets
# Faucets

Get sepolia ETH from these faucets so you can fund your wallet to send transactions and deploy contracts on Ink Sepolia. You can also [bridge](/quick-start/faucets#bridging-funds-to-ink-sepolia) testnet funds to Ink.
Get sepolia ETH on Ink from these faucets below! Alternatively, you can [bridge](https://inkonchain.com/bridge) testnet funds to Ink.

## [Ink](https://inkonchain.com/faucet)

###### Ink
Our in house faucet provides a quick and easy way to acquire testnet ETH.
- https://inkonchain.com/faucet
###### Optimism Superchain Faucet
The Superchain Faucet provides testnet ETH for Ink and all other OP chains. Sign in to claim 0.10 test ETH on 1 network every 24 hours or verify your onchain identity for more tokens.
- https://console.optimism.io/faucet
###### QuickNode
Use QuickNode Faucet to claim Ink Sepolia for testnet ETH for free - one drip per network every 12 hours.
- https://faucet.quicknode.com/drip
###### Gelato
Gelato's Faucet uses Cloudflare authentication and drops up to 0.3 Ink Sepolia ETH every 12 hours.
- https://faucet-gel-sepolia.inkonchain.com

## Bridging funds to Ink Sepolia
## [Optimism Superchain Faucet](https://console.optimism.io/faucet)

If you need an alternative to the above faucets you can choose to bridge ETH onto Ink Sepolia.
The Superchain Faucet provides testnet ETH for Ink and all other OP chains. Sign in to claim 0.10 test ETH on 1 network every 24 hours or verify your onchain identity for more tokens.

## [QuickNode](https://faucet.quicknode.com/drip)

1. Get sepolia ETH by using your wallet with one of the existing faucets on the Ethereum Sepolia network:
Use QuickNode Faucet to claim Ink Sepolia for testnet ETH for free - one drip per network every 12 hours.

* [https://console.optimism.io/faucet](https://console.optimism.io/faucet)
* [https://www.alchemy.com/faucets/ethereum-sepolia](https://www.alchemy.com/faucets/ethereum-sepolia)
* [https://faucet.quicknode.com/ethereum/sepolia](https://faucet.quicknode.com/ethereum/sepolia)
* [https://cloud.google.com/application/web3/faucet/ethereum/sepolia](https://cloud.google.com/application/web3/faucet/ethereum/sepolia)
## [Gelato](https://faucet-gel-sepolia.inkonchain.com)

2. Transfer your ETH to <CopyableCode code="0x33f60714bbd74d62b66d79213c348614de51901c" />.
- This is the [`L1StandardBridge Contract`](https://eth-sepolia.blockscout.com/address/0x33f60714BbD74d62b66D79213C348614DE51901C).
- This contract will help you send your ETH from Sepolia to Ink Sepolia.
- Once the transaction is confirmed you will quickly receive Ink ETH in your wallet.
Gelato's Faucet uses Cloudflare authentication and drops up to 0.3 Ink Sepolia ETH every 12 hours.
7 changes: 5 additions & 2 deletions src/content/shared/multisig-content.mdx
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Multisig Solutions
# Multisig

## Safe
Ink hosts [Safe](https://docs.safe.global/home/what-is-safe)'s technology to bring digital ownership of accounts to everyone by building universal and open contract standards for the custody of digital assets, data, and identity.
Expand All @@ -9,4 +9,7 @@ Using Safe you can:
- Access your safe using Web, Mobile and Desktop apps.
- Safe also features access to DeFi, open source code, batch transactions, modular extensions, gasless signatures and more.

Safe is available on Ink Sepolia through the Optimism Safe portal: https://safe.optimism.io/welcome/accounts?chain=ink-sepolia
**Supported Netowkrs**
- [Ink Sepolia](https://safe.optimism.io/welcome/accounts?chain=ink-sepolia)
- [Ink Mainnet](https://app.safe.global/new-safe/load?chain=ink)

72 changes: 50 additions & 22 deletions src/pages/_meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@
"pagination": false
}
},

"404": {
"title": "404",
"display": "hidden",
Expand All @@ -23,7 +22,6 @@
"pagination": false
}
},

"500": {
"title": "500",
"display": "hidden",
Expand All @@ -36,8 +34,6 @@
"pagination": false
}
},


"header_status": {
"title": "Status Page",
"type": "page",
Expand All @@ -47,35 +43,67 @@
"header_faucet": {
"title": "Faucets",
"type": "page",
"href": "/quick-start/faucets"
"href": "/tools/faucets"
},
"--- GENERAL": {
"title": "General",
"type": "separator"
},


"general": {
"title": "General"
"title": "General",
"display": "children"
},


"quick-start": {
"title": "Quick Start"
"+++ Build on Ink": {
"title": "",
"type": "separator"
},

"use-ink": {
"title": "Use Ink"
"--- Build On Ink": {
"title": "Build On Ink",
"type": "separator"
},

"build": {
"title": "Build on Ink"
"title": "Build on Ink",
"display": "children"
},
"+++ Tools": {
"title": "",
"type": "separator"
},
"--- Tools": {
"title": "Tools",
"type": "separator"
},
"tools": {
"title": "Tools",
"display": "children"
},
"+++ Useful Information": {
"title": "",
"type": "separator"
},
"--- Useful Information": {
"title": "Useful Information",
"type": "separator"
},
"useful-information": {
"title": "Useful Information",
"display": "children"
},
"+++ Work with Ink": {
"title": "",
"type": "separator"
},
"--- Work with Ink": {
"title": "Work with Ink",
"type": "separator"
},


"work-ink": {
"work-with-ink": {
"title": "Work with Ink",
"display": "children",
"theme": {
"pagination": true
}
},

"---": {
"type": "separator"
},
Expand All @@ -90,4 +118,4 @@
"pagination": false
}
}
}
}
14 changes: 8 additions & 6 deletions src/pages/build/_meta.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
{
"getting-started": "Getting Started",
"onchain-clients": "Onchain Clients",
"oracles": "Oracles",
"run-an-ink-node": "Running Ink Nodes",
"fees": "Fees",
"run-an-ink-node": {
"title": "Running Ink Nodes",
"href": "https://github.com/inkonchain/node",
"newWindow": true
},
"transaction-fees": "Transaction Fees",
"ink-kit": "Ink Kit",
"tutorials": "Tutorials",
"tools": "Tools",
"useful-info": "Useful Information"
"tutorials": "Tutorials"
}
23 changes: 23 additions & 0 deletions src/pages/build/getting-started.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
import { Callout, Checkbox } from "nextra/components";

# What do I Need to Start Developing on Ink?

To start developing on Ink, you'll need:

- [ ] An IDE (integrated developer environment) like [Visual Studio Code](https://code.visualstudio.com/), [Cursor](https://cursor.sh/), or [Remix](https://remix.ethereum.org/) to write smart contracts in solidity.

- [ ] A wallet that holds ETH such as [Kraken Wallet](https://www.kraken.com/wallet), [MetaMask](https://metamask.io/), or [Rainbow](https://rainbow.me/).

- We suggest having at least 0.01 ETH for standard deployments on Ink.
- You can request Ink Sepolia ETH using our [Faucets](/tools/faucets).

- [ ] We recommend using a development framework like [Foundry](https://github.com/foundry-rs/foundry) or [Hardhat](https://hardhat.org/)

- [Guide to deploy a contract using Foundry](/build/tutorials/deploying-a-smart-contract/foundry)
- [Guide to deploy a contract using Hardhat](/build/tutorials/deploying-a-smart-contract/hardhat)
- [Guide to deploy a contract using Remix](/build/tutorials/deploying-a-smart-contract/remix)

<Callout type="info" emoji="ℹ️">
Try out InkGPT! Blaze through the docs and get deployed in no time with our
new AI assistant.
</Callout>
40 changes: 0 additions & 40 deletions src/pages/build/oracles.mdx

This file was deleted.

Loading
Loading