Kit 191 4 hours get the upstream solana explorer working manually

.env.example

@@ -0,0 +1,4 @@
+# Fill these out with a custom RPC url to test the explorer locally without getting rate-limited
+NEXT_PUBLIC_MAINNET_RPC_URL=
+NEXT_PUBLIC_DEVNET_RPC_URL=
+NEXT_PUBLIC_TESTNET_RPC_URL=

.pnpmfile.cjs

@@ -0,0 +1,48 @@
+//@ts-check
+
+// https://pnpm.io/pnpmfile
+// https://github.com/pnpm/pnpm/issues/4214
+// https://github.com/pnpm/pnpm/issues/5391
+
+const rootPkg = require('./package.json');
+
+console.log (`Checking for package peerDependency overrides`);
+
+const remapPeerDependencies = [
+  { package: '@solana-program/compute-budget', packageVersion: '0.6.1', peerDependency: '@solana/web3.js', newVersion: '2.0.0' },
+];
+
+function overridesPeerDependencies(pkg) {
+  if (pkg.peerDependencies) {
+    remapPeerDependencies.map(dep => {
+      if (pkg.name === dep.package && pkg.version.startsWith(dep.packageVersion)) {
+        console.log(`  - Checking ${pkg.name}@${pkg.version}`); // , pkg.peerDependencies);
+
+        if (dep.peerDependency in pkg.peerDependencies) {
+          try {
+            console.log(`    - Overriding ${pkg.name}@${pkg.version} peerDependency ${dep.peerDependency}@${pkg.peerDependencies[dep.peerDependency]}`);
+
+            // First add a new dependency to the package and then remove the peer dependency.
+            // This approach has the added advantage that scoped overrides should now work, too.
+            pkg.dependencies[dep.peerDependency] = dep.newVersion;
+            delete pkg.peerDependencies[dep.peerDependency];
+
+            console.log(`      - Overrode ${pkg.name}@${pkg.version} peerDependency ${dep.peerDependency}@${pkg.dependencies[dep.peerDependency]}`);
+          } catch (err) {
+            console.error(err);
+          }
+        }
+      }
+    });
+  }
+}
+
+module.exports = {
+  hooks: {
+    readPackage(pkg, _context) {
+      // skipDeps(pkg);
+      overridesPeerDependencies(pkg);
+      return pkg;
+    },
+  },
+};

README.md

@@ -6,16 +6,39 @@
 
 ## Development
 
+Contributing to the Explorer requires `pnpm` version `9.10.0`. 
+Once you have this version of `pnpm`, you can continue with the following steps.
+
+
+-   Copy `.env.example` into `.env` & fill out the fields with custom RPC urls \
+    from a Solana RPC provider. You should not use `https://api.mainnet-beta.solana.com` \
+    or `https://api.devnet.solana.com` or else you will get rate-limited. These are public \
+    endpoints not suitable for application development. You must set these URLs with \
+    endpoints from your own provider.
+
+-   `pnpm i` \
+    Installs all project dependencies using pnpm package manager. This will create a \
+    `node_modules` directory and install all packages specified in `package.json`, \
+    including both dependencies and devDependencies.
+
 -   `pnpm dev` \
     Runs the app in the development mode. \
     Open [http://localhost:3000](http://localhost:3000) to view it in the browser. \
     \
     The page will reload if you make edits. \
     You will also see any lint errors in the console.
 
--   `pnpm test` \
+-   (Optional) `pnpm test` \
     Launches the test runner in the interactive watch mode.<br />
 
+## Troubleshooting
+
+Still can't run the explorer with `pnpm dev`? 
+Seeing sass dependency errors?
+Make sure you have `pnpm` version `9.10.0`, `git stash` your changes, then blow reset to master with `rm -rf node_modules && git reset --hard HEAD`.
+Now running `pnpm i` followed by `pnpm dev` should work. If it is working, don't forget to reapply your changes with `git stash pop`.
+
+
 # Disclaimer
 
 All claims, content, designs, algorithms, estimates, roadmaps,

app/address/[address]/anchor-account/page.tsx

@@ -11,8 +11,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `Contents of the Anchor Account at address ${props.params.address} on Solana`,
-        title: `Anchor Account Data | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `Contents of the Anchor Account at address ${props.params.address}`,
+        title: `Anchor Account Data | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }
 

app/address/[address]/anchor-program/page.tsx

@@ -12,8 +12,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `The Interface Definition Language (IDL) file for the Anchor program at address ${props.params.address} on Solana`,
-        title: `Anchor Program IDL | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `The Interface Definition Language (IDL) file for the Anchor program at address ${props.params.address}`,
+        title: `Anchor Program IDL | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }
 

app/address/[address]/attributes/page.tsx

@@ -11,8 +11,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `Attributes of the Metaplex NFT with address ${props.params.address} on Solana`,
-        title: `Metaplex NFT Attributes | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `Attributes of the Metaplex NFT with address ${props.params.address}`,
+        title: `Metaplex NFT Attributes | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }
 

app/address/[address]/blockhashes/page.tsx

@@ -7,8 +7,8 @@ type Props = Readonly<{
 }>;
 
 export const metadata = {
-    description: `Recent blockhashes on Solana`,
-    title: `Recent Blockhashes | Solana`,
+    description: `Recent blockhashes`,
+    title: `Recent Blockhashes | Zuma`,
 };
 
 export default function RecentBlockhashesPage(props: Props) {

app/address/[address]/compression/page.tsx

@@ -11,8 +11,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `Information about the Compressed NFT with address ${props.params.address} on Solana`,
-        title: `Compression Information | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `Information about the Compressed NFT with address ${props.params.address}`,
+        title: `Compression Information | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }
 

app/address/[address]/concurrent-merkle-tree/page.tsx

@@ -11,8 +11,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `Contents of the SPL Concurrent Merkle Tree at address ${props.params.address} on Solana`,
-        title: `Concurrent Merkle Tree | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `Contents of the SPL Concurrent Merkle Tree at address ${props.params.address}`,
+        title: `Concurrent Merkle Tree | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }
 

app/address/[address]/domains/page.tsx

@@ -10,8 +10,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `Domain names owned by the address ${props.params.address} on Solana`,
-        title: `Domains | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `Domain names owned by the address ${props.params.address}`,
+        title: `Domains | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }
 

app/address/[address]/entries/page.tsx

@@ -11,8 +11,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `Entries of the address lookup table at ${props.params.address} on Solana`,
-        title: `Address Lookup Table Entries | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `Entries of the address lookup table at ${props.params.address}`,
+        title: `Address Lookup Table Entries | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }
 

app/address/[address]/instructions/page.tsx

@@ -10,8 +10,8 @@ type Props = Readonly<{
 
 export async function generateMetadata(props: AddressPageMetadataProps): Promise<Metadata> {
     return {
-        description: `A list of transactions that include an instruction involving the token with address ${props.params.address} on Solana`,
-        title: `Token Instructions | ${await getReadableTitleFromAddress(props)} | Solana`,
+        description: `A list of transactions that include an instruction involving the token with address ${props.params.address}`,
+        title: `Token Instructions | ${await getReadableTitleFromAddress(props)} | Zuma`,
     };
 }