{"id":20617620,"url":"https://github.com/humandataincome/ipdw","last_synced_at":"2025-04-15T11:31:03.945Z","repository":{"id":63940771,"uuid":"527987847","full_name":"humandataincome/ipdw","owner":"humandataincome","description":"InterPlanetary Data Wallet (IPDW): store users data within a secure distributed storage. It enables to build a real decentralised network (Web 0) without the need of centralized database.","archived":false,"fork":false,"pushed_at":"2024-09-26T10:03:17.000Z","size":966,"stargazers_count":11,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-23T20:48:37.061Z","etag":null,"topics":["crdt","database","decentralized","dht","distributed","helia","ipdw","ipfs","libp2p","local-first","p2p","peer-to-peer","web3"],"latest_commit_sha":null,"homepage":"https://ipdw.tech","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/humandataincome.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-23T12:47:41.000Z","updated_at":"2025-02-20T20:37:39.000Z","dependencies_parsed_at":"2023-12-17T17:41:08.416Z","dependency_job_id":"536a3ccd-8888-4f9f-b284-20285c07a0ff","html_url":"https://github.com/humandataincome/ipdw","commit_stats":{"total_commits":161,"total_committers":2,"mean_commits":80.5,"dds":0.03105590062111796,"last_synced_commit":"5859c2f4b2677867686a2759597261a5b4c0acad"},"previous_names":["humandataincome/ipdw","ansi-code/ipdw"],"tags_count":55,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humandataincome%2Fipdw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humandataincome%2Fipdw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humandataincome%2Fipdw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/humandataincome%2Fipdw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/humandataincome","download_url":"https://codeload.github.com/humandataincome/ipdw/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249060920,"owners_count":21206417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crdt","database","decentralized","dht","distributed","helia","ipdw","ipfs","libp2p","local-first","p2p","peer-to-peer","web3"],"created_at":"2024-11-16T12:05:01.782Z","updated_at":"2025-04-15T11:31:03.918Z","avatar_url":"https://github.com/humandataincome.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ipdw (InterPlanetary Data Wallet)\n\nInterPlanetary Data Wallet (IPDW): store users data within a secure distributed storage.\nIt enables to build a real decentralised network (Web 0) without the need of centralized database.\nYou can take advantage of P2P interactions, database-less, conflict-free replication, and much more.\nThe main idea is to shard data structures in blocks and to propagate them encrypted and signed.\n\n\u003cimg src=\"assets/logo.svg\" width=\"256\" alt=\"logo\"/\u003e\n\n[![npm (scoped)](https://img.shields.io/npm/v/ipdw)](https://www.npmjs.com/package/ipdw) [![node-current (scoped)](https://img.shields.io/node/v/idpw)](https://www.npmjs.com/package/ipdw)\n\n## Features\n\n- Store unstructured data\n- Authenticate with web3 keys\n- Enjoy p2p interactions\n- Deploy database-less apps\n- Unlimited scalability\n- Conflict-free\n- And much more!\n\n## Decentralized authentication\n\nEveryone has a key pair, consisting of a public key and a private key, which can be saved in different formats (such as the BIP39 standard for mnemonic phrases-based deterministic key generation).\n\nIn Web 3.0 applications, your wallet address (derived from the public key) can be recognized, allowing you to act on the distributed ledger (the storage) as a well-identified identity.\n\n## Getting Started\n\nTo get started with IPDW, you will need to follow these steps:\n\nInstall the package:\n\n```bash\n$ npm install ipdw\n```\n\nInstantiate ipdw with this interface:\n\n```\npublic static async create(privateKey: string, storageProvider: StorageProvider, salt?: Buffer): Promise\u003cIPDW\u003e\n```\n\nThen access to \"data\", which is a sharded map where you can get and set in a key-value style.\n\nThe full example with auto synchronization between devices:\n\n```js\nimport {IPDW, MemoryStorageProvider} from \"ipdw\";\n\n// On device 1\n(async function () {\n    const privateKey = '0xb577c4367d79f1a7a0c8353f7937d601758d92c35df958781d72d70f9177e52f';\n    const provider = await IPDWStorageProvider.Init(privateKey, new MemoryStorageProvider());\n    const dataWallet = await DataWallet.Create(privateKey, provider);\n    \n    await dataWallet.set('test1', 'hello');\n\n    const value1 = await dataWallet.get('test1');\n    console.log('test1 value:', value1);\n    // test1 value: hello\n\n    // Run \"device 2\" and if reachable it will be discovered and synced\n    const value2 = await dataWallet.get('test2');\n    console.log('test2 value:', value2);\n    // test2 value: world\n})();\n\n// On device 2\n(async function () {\n    const privateKey = '0xb577c4367d79f1a7a0c8353f7937d601758d92c35df958781d72d70f9177e52f';\n    const provider = await IPDWStorageProvider.Init(privateKey, new MemoryStorageProvider());\n    const dataWallet = await DataWallet.Create(privateKey, provider);\n    \n    await ipdw.data.set('test2', 'world');\n})();\n```\n\n## Data Wallet Principles\n\nThe InterPlanetary Data Wallet is a sophisticated mechanism for storing all kinds of data that works offline and only partially exposes the data during a transaction. The data is encrypted, so it can be safely shared without knowing the passphrase.\n\nThe wallet can be synced between all your devices using P2P communication strategies like IPFS and IPNS, and is always offline until a transaction occurs.\n\n## Security and Design\n\nThe blockchains have different replicated and redundant ledgers and consensus algorithms, with a competition underway to find the best algorithm for increased throughput, security, and more.\n\nThanks to applications like Metamask/Trust, Web 3.0 users are now familiar with private key usage and management. These applications have simplified the user experience, making it easy for users to manage keys and sign messages using ECDSA.\n\nPrivate keys and public keys are nearly invulnerable to attacks from computers, except for social/phishing and similar attacks. \"Humans are always the vulnerable element in the chain,\" so it's important to always be cautious.\n\n## Contributing\n\nWe welcome contributions to IPDW! If you would like to contribute, please follow these steps:\n\n1. Fork the repository\n2. Create a new branch for your changes\n3. Commit your changes and open a pull request\n4. Support\n\nIf you need help using IPDW or have any questions, please open an issue in this repository and we will be happy to assist you.\n\n## License\n\nThis project is licensed under the Apache 2.0 License. See the [LICENSE](./LICENSE) file for details.\n\nWe hope you will join us in our mission to defeat internet data centralization!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumandataincome%2Fipdw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhumandataincome%2Fipdw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhumandataincome%2Fipdw/lists"}