Merge pull request #158 from spacescan-io/sabari

Added exchange integration

docs/guide/exchange_integration/exchange_integration.md

@@ -0,0 +1,139 @@
+---
+sidebar_position: 10
+---
+
+# Exchange Integration
+
+Spacescan.io is the leading blockchain explorer for Chia Network, officially recognized and integrated into Chia native wallets. With high availability and comprehensive API support, we provide exchanges the most reliable way to:
+
+- Track transactions and balances in real-time
+- Verify blockchain data with confidence
+- Provide users with easy access to transaction history
+
+This guide explains how to integrate Spacescan.io links into your exchange platform to provide users with detailed information about Chia (XCH) addresses, transactions, and blocks.
+
+## Address Explorer Integration
+
+You can link any XCH address to Spacescan.io by appending the address to the base URL:
+
+```
+https://www.spacescan.io/address/{xch_address}
+```
+
+### Example
+```
+https://www.spacescan.io/address/xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8
+```
+
+![Address Explorer](address-explorer.png)
+
+The address explorer shows:
+- Current balance
+- Transaction history
+- Incoming/outgoing transactions
+- NFT holdings
+- CAT token balances
+
+## Transaction Explorer Integration
+
+To link to transaction details, append the transaction/coin ID to the base URL:
+
+```
+https://www.spacescan.io/coin/{transaction_id}
+```
+
+### Example
+```
+https://www.spacescan.io/coin/0x99ca7ff010b9e26176d998288006f1efcac9d84af3655a0152e0d44b5d3def1d
+```
+
+![Transaction Explorer](transaction-explorer.png)
+
+The transaction explorer shows:
+- Transaction amount
+- Sender and recipient addresses
+- Transaction timestamp
+- Block confirmation details
+- Transaction status
+
+## Block Explorer Integration
+
+To link to block details, append the block height to the base URL:
+
+```
+https://www.spacescan.io/block/{block_height}
+```
+
+### Example
+```
+https://www.spacescan.io/block/6325004
+```
+
+![Block Explorer](block-explorer.png)
+
+The block explorer shows:
+- Block hash
+- Block timestamp
+- Farmer address
+- Block rewards
+- Transactions in the block
+- Block weight and other metadata
+
+## Implementation Examples
+
+### HTML Link
+```html
+<!-- Address Link -->
+<a href="https://www.spacescan.io/address/xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8" target="_blank">
+  View on Spacescan
+</a>
+
+<!-- Transaction Link -->
+<a href="https://www.spacescan.io/coin/0x99ca7ff010b9e26176d998288006f1efcac9d84af3655a0152e0d44b5d3def1d" target="_blank">
+  View Transaction
+</a>
+
+<!-- Block Link -->
+<a href="https://www.spacescan.io/block/6325004" target="_blank">
+  View Block
+</a>
+```
+
+### JavaScript
+```javascript
+function getSpacescanUrl(type, id) {
+  const baseUrl = 'https://www.spacescan.io';
+
+  switch(type) {
+    case 'address':
+      return `${baseUrl}/address/${id}`;
+    case 'transaction':
+      return `${baseUrl}/coin/${id}`;
+    case 'block':
+      return `${baseUrl}/block/${id}`;
+    default:
+      throw new Error('Invalid type');
+  }
+}
+
+// Usage
+const addressUrl = getSpacescanUrl('address', 'xch1a6cd558gqsz2hch5pt0l8mx7zhavf32q5lyde09zjtqcmkelr9ns59k0j8');
+const txUrl = getSpacescanUrl('transaction', '0x99ca7ff010b9e26176d998288006f1efcac9d84af3655a0152e0d44b5d3def1d');
+const blockUrl = getSpacescanUrl('block', '6325004');
+```
+
+## Best Practices
+
+1. Always open Spacescan links in a new tab using `target="_blank"` to preserve the user's exchange session.
+
+2. Include tooltips or labels to clearly indicate that the link will take users to Spacescan.io.
+
+3. Consider adding the Spacescan logo next to explorer links for better user recognition.
+
+
+## Support
+
+For technical support or questions about integration, please contact:
+- Email: [email protected]
+- Discord: [Join Spacescan Discord](https://discord.gg/spacescan)
+- Twitter: [@spacescan_io](https://twitter.com/spacescan_io)

sidebars.js

@@ -27,7 +27,7 @@ const sidebars = {
     {
       type: 'category',
       label: 'Guide',
-      items: ['guide/verifyDID','guide/updatecatinfo','guide/chia_tax','guide/manage_address_profile/manage_address_profile','guide/chia_did_profile/chia_did_profile','guide/manage_asset_monitor/asset_monitor','guide/manage_token_data/token_edit_data','guide/manage_collection/manage_collection'],
+      items: ['guide/verifyDID','guide/updatecatinfo','guide/chia_tax','guide/manage_address_profile/manage_address_profile','guide/chia_did_profile/chia_did_profile','guide/manage_asset_monitor/asset_monitor','guide/manage_token_data/token_edit_data','guide/manage_collection/manage_collection','guide/exchange_integration/exchange_integration'],
       collapsible: true,
       collapsed: false,
     },