GithubHelp home page GithubHelp logo

safe-global / safe-docs Goto Github PK

View Code? Open in Web Editor NEW
47.0 47.0 66.0 20.79 MB

Developer Docs for building on Safe.

Home Page: https://docs.safe.global

License: MIT License

JavaScript 0.30% Shell 0.01% TypeScript 19.21% CSS 1.37% MDX 79.12%
developer-tools documentation ethereum safe smart-contracts

safe-docs's People

Contributors

adam-hurwitz avatar ademidun avatar biafra23 avatar dasanra avatar davizalpe avatar denisgranha avatar dependabot[bot] avatar eccogrinder avatar falvaradorodriguez avatar fmrsabino avatar germartinez avatar giacomolicari avatar iamacook avatar jpalvarezl avatar kevinlu avatar louis-md avatar lukasschor avatar mareeng avatar med3000 avatar moisses89 avatar nlordell avatar pbillingsby avatar pucedoteth avatar remedcu avatar rmeissner avatar tanay1337 avatar tania-ptichka avatar tschubotz avatar uxio0 avatar yagopv avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

safe-docs's Issues

Confusion about docs/tutorial_tx_service_initiate_sign

A user pointed out that the phrasing is misleading in: docs/tutorial_tx_service_initiate_sign

"signature": "<0x prefixed hex string>", // One or more ethereum ECDSA signatures of the contractTransactionHash as an hex string

It wasn't clear how multiple signatures need to be formatted as arrays are not accepted.

We could rephrase the comment to:

"signature": "<0x prefixed hex string>", // One or more ethereum ECDSA signatures of the contractTransactionHash as an hex string. See: signature types)

Remove hardcoded paths

In multiple places asset paths are hardcoded (e.g. fonts, images) this cause them not to work properly (e.g. in staging).

Production works by "accident" since the required files have been deployed to root at some point before the sub directory change.

See gnosis/dex-docs@8f8b04d

Add more information for ModuleManager and OwnerManager

It would be nice to have separate section for the ModuleManager and OwnerManager contract.

For the ModuleManager it should be outlined how modules are stored and managed. Also shortly explain one module to show how the interaction with the safe works and what needs to be implemented (e.g. replay protection)

For the OwnerManager it should be outlined how owners are stored and managed. Also mention scenarios where transactions might fail.

Compatibility issues with web3auth >4.0.0 for auth kit

image

The code snippet above provided in the docs on the auth-kit section installs the latest version of web3auth i.e. v7. v7 is not compatible with safe libraries and is throwing errors. Would be helpful if the supported web3auth version i.e v4 is mentioned in the docs

Transition periods for nomenclature changes

Problem

Recently there has been renaming of transaction guards and modules. The choices behind this change in naming are outside of scope of this issue filing. The issue this creates is those that have already been actively building on Safe now find a change in documentation which is incongruent with the smart contract nomenclature implementing the features.

Proposed Solution

Projects choose to change nomenclature from time to time for various reasons. A transition period (read: 6 months - 12 months arbitrarily, or more accurately determined from market research) should be adopted during which times nomenclature changes are accompanied with a NOTE section indicating such history.

Example JS code is broken/outdated

Apologies if this isn't the right repo. Couldn't find the source for this safe transaction service tutorial anywhere, but this seems like the best fit.

The linked page mentions that:

If you can code in Javascript, you can edit this example to fit your needs: https://gist.github.com/rmeissner/0fa5719dc6b306ba84ee34bebddc860b

I've been trying to run that example (specifically, it's submit function) by just modifying the arguments therein, but keep running into issues related to signing.

Firstly, the endpoint tells me that the Contract-transaction-hash=0xaaa... does not match provided contract-tx-hash=0xbbb....
If I then hardcode the contractTransactionHash it expects, it tells me Signer=0xccc... is not an owner or delegate. The signer address it gives though isn't an address related to the private key I passed in.

This feels vaguely like address recovery from the signed message, on the Gnosis service's end, is happening incorrectly, or mismatching with the way signing happens locally.
(Passing a chainId argument into the signing function does change the recovered address compared to not passing the argument, but still doesn't give an expected result.)

Notably, I ran into the same issues when hand-rolling my own version of this code, as well as when following the set delegate tutorial, so perhaps the issue is deeper than just this gist.

Link Checker Report

Summary

Status Count
πŸ” Total 445
βœ… Successful 423
⏳ Timeouts 0
πŸ”€ Redirected 0
πŸ‘» Excluded 1
❓ Unknown 0
🚫 Errors 21

Errors per input

Errors in other/things-you-can-do-with-safe.md

Errors in other/built-on-safe.md

Errors in examples/README.md

  • [ERR] file:///home/runner/work/safe-docs/safe-docs/learn/safe-core/safe-core-account-abstraction-sdk/relay-kit.md | Failed: Cannot find file

Errors in other/what-is-a-smart-account.md

Errors in other/other-tools.md

  • [ERR] file:///home/runner/work/safe-docs/safe-docs/other/safe-core/safe-core-account-abstraction-sdk/protocol-kit/core-sdk.md | Failed: Cannot find file

Errors in safe-core-sdk/safe-apps/README.md

Errors in safe-smart-account/security/past-paid-bounties.md

Errors in contact-us.md

Errors in safe-core-sdk/safe-apps/get-started.md

Three Broken Links

The Safe App tutorial found at https://docs.gnosis.io/safe/docs/sdks_safe_apps/ contains a list of links to existing safe apps. Two of which (as far as I can tell) are broken.

Also, perhaps this would be a good place to update the list to include Wallet Connect

Graph for Personal Edition Creation

It would be nice to have a graph displaying the deployment of a proxy for the Gnosis Safe Personal Edition. Currently it is only outlined and the video of the dappcon talk is linked.

Add current challenges to the documentation

The documentation reference the following:

  • Complexity of the Smart Contracts and why formal verification is important
  • Contract Signatures - mention that smart contracts cannot sign messages and reference EIP1271 (Standard Signature Validation Method for Contracts)
  • Delegates in State Channels

Goerli testnet deprecated

Hi,
I want to deploy a dapp that is Ethereum based. For testing purposes, I want to use Testnet but the only Testnet available in safe services is Goerli which will be deprecated until the end of the year and already has many problems to use. I wanted to know if there are going to be any Testnet chains in available services soon.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.