home *** CD-ROM | disk | FTP | other *** search
/ DEFCON 12 / DEFCON_12_CD-ROM_2004.iso / Wavyhill / Oz_demo / README.txt
Text File  |  2004-07-03  |  22KB  |  450 lines

  1.  
  2.  
  3.     HELP CONTENTS
  4.  
  5. I - Introduction.
  6.     * What this is.
  7.     * The general Idea.
  8.  
  9. II - Nyms.
  10.     * What's in a Nym?
  11.     * Making and Using Nyms.
  12.  
  13. III - Locales.
  14.     * Making and Visiting Locales.
  15.     * A place to meet and negotiate.
  16.     * A place to keep coins.
  17.     * Locking the door (not).
  18.  
  19. IV - Coins.
  20.     * A flexible store of value.
  21.     * Where do they come from?
  22.     * Making your own coins.
  23.     * How to tell what they're worth.
  24.     * Passing them around.
  25.  
  26. V - The OZ desktop.
  27.     * The main menu.
  28.     * The Nym, Coin, and Locale popup menus.
  29.     * Entering a Locale, a window on another place.
  30.     * Talk Windows.
  31.     * Making reputation reports.
  32.  
  33. VI - Advanced.
  34.     * Denominations.
  35.     * Reputation server settings
  36.  
  37. VII - CAVEAT.
  38.     * Some Warnings, what this is NOT.
  39.  
  40. VIII - INSTALLATION.
  41.     * Out of the box.
  42.     * The Client
  43.     * The server.
  44.     * The Reputation Website App.
  45.  
  46.  
  47.  
  48.  
  49.             I - INTRODUCTION.
  50.  
  51. OZ is a privacy tool that creates an anonymous interactive environment 
  52. for financial transactions. It is not an online bank, a payment service,
  53. or a digital currency. It's more like a combination of a chat room and a 
  54. digital wallet that lets you mint your own coins.
  55.  
  56. In Oz, there is no authority, no coercion, no central point of control,
  57. ownership, or vulnerability. There is no record-keeping mechanism. Identities
  58. can be authenticated but not traced to physical persons. Instead, there are
  59. Nyms, Coins, and Locales. You go to some locale, meet and converse with other
  60. Nyms there, and put down or pick up coins.(CAVEAT: The current version is
  61. neither anonymous, secure, nor decentralized. See section VII.)
  62.  
  63. Sections II, III, and IV explain what you can do and why. Sections V and VI
  64. go into more detail on the 'how', and discuss the various menus and windows.
  65. Section VII Explains the current status and limitations of the Oz network.
  66. Section VIII Tells how to install and setup this stuff.
  67.  
  68.  
  69.  
  70.             II - NYMS.
  71.  
  72. Nym is short for pseudonym. A Nym is an identity. You can make and use as 
  73. many of them as you like. One could be how most of your friends and associates
  74. know you. You could have another for shopping, another for that forum you
  75. don't want even your friends to know you're in, another for purchasing erotica,
  76. another for dealing with the Venusian agent you sell nuclear secrets to, and
  77. so on.
  78.  
  79. You can switch between Nyms whenever you like. You can erase a Nym when it's 
  80. no longer needed, but you may be burning some bridges. Think it through.
  81.  
  82. In Oz, people aren't dealing with you, they see only your current Nym. You 
  83. will probably want to make and use at least one Nym consistently so it can 
  84. build a reputation. No one else can make or use the same Nym, and everyone
  85. can tell if it's the same one they've seen before. Coins and locales are
  86. tagged with the Nym that created them.(CAVEAT - THIS IS NOT YET TRUE. SEE
  87. SECTION VI)
  88.  
  89.  
  90.  
  91.             III - LOCALES.
  92.  
  93. A locale is a place to meet, converse, and trade with other Nyms. You can only 
  94. get there by knowing it's name. If you aren't there, you can't do any of these
  95. things. You can be in more than one locale at the same time. Locales and their 
  96. contents are stored in a secure, redundant and distributed way such that they 
  97. cannot be seen or corrupted by others, nor can your access to them be hampered.
  98. You can make and erase locales, and enter or leave them. If you made a locale,
  99. then you can restrict entry to a specific list of Nyms. (CAVEAT - SEE SECTION
  100. VII)
  101.  
  102. One use for a locale is as a place to keep coins. This is in some ways like a 
  103. bank account. To keep the contents safe, either don't tell anyone it's name, or
  104. restrict entry to a 'door list' of one --- yourself.
  105.  
  106. Locales are primarily places to rendezvous with other Nyms. Some are like a 
  107. meeting place for those with a common interest or purpose. Some are known
  108. for the types of products or services offered there. Some are Index Locales,
  109. places that contain lists of or advertisements for other places. Expect other
  110. creative uses for them to appear.(CAVEAT - SEE SECTION VII)
  111.  
  112.  
  113.  
  114.             IV - COINS.
  115.  
  116. A coin is a store of value, that is, it represents something of value. That
  117. could be US dollars, Georgian Lari, E-gold grams, goats, an acre of prime
  118. Florida swamp, or a Ming vase. A digital signature guarantees that it was
  119. issued by who it says, and that no one has changed it since then. If I give
  120. you a Ming Vase coin, it is my promise that you can exchange it for the vase
  121. whenever you like. The same goes for a $100 USD coin. The issuer promises to
  122. exchange it for $100, for anyone, at any time. It is a promise to pay the
  123. bearer. This is the essence of money. It's value depends entirely on your 
  124. trust in the issuer.
  125.  
  126. Normally you store your coins in special locales you keep a secret from others.
  127. you can also keep them on your Oz desktop or other computer files. In fact,
  128. you can keep them on any data storage medium you like (and trust). You could
  129. even print them out and keep them in your wallet, but it will be a pain to
  130. get them back in. Consider having locales to store coins for shopping, savings,
  131. assets (the vase, the swamp), receipts (the investment fund, the rent deposit),
  132. and so on.
  133.  
  134. To sell you my Ming vase, we meet in some locale, I plop down my vase coin,
  135. you plop down your  10 EU-1000 coins, you pick up the vase coin, I pick up 
  136. the Euros, thank you very much and see you later. Of course, either one of us
  137. could just grab everything and run. If trust is an issue, escrow the transaction
  138. briefly through a trusted third party or use one of the other trust management
  139. techniques mentioned in "Toward A Private Digital Economy". Eventually
  140. this process will be automated and invisible.
  141.  
  142. Coins are easy to copy, so I could sell my vase several times if I wanted.
  143. This is called the double-spend problem. To keep this from happening, as
  144. soon as you get a coin from someone, you have it re-issued. That is, you 
  145. give it back to the issuer in exchange for a new coin of equivalent value, 
  146. but one of which nobody has a copy. In Oz, this is a one-click operation.
  147. Before you accept a coin, you might want to make sure it's valid (that the
  148. issuer of the coin agrees that it's his coin, it hasn't been already spent,
  149. and that he will still redeem it). In Oz, this is also a one-click operation.
  150.  
  151.  
  152.  
  153.             V - THE OZ DESKTOP.
  154.  
  155. The Oz interface is composed of: 
  156.     The desktop or main window.
  157.     The Main Menu (FILE COIN SETTINGS HELP)
  158.     Nym, locale and coin icons (and their pop-up menus).
  159.     Presence and talk windows.
  160.  
  161. The desktop is a place to keep your Nyms, frequently visited locales,
  162. and coins that aren't in a locale. You can click-and-drag anything
  163. that's on it. Along the top is the usual main menu.
  164.  
  165.  
  166.   FILE MAIN MENU.
  167.  
  168. The SAVE and LOAD options save and restore any coins that are on the desktop,
  169. which locales are visible on the desktop (but not their contents), the 
  170. size and location of things on it, and various other program settings. 
  171. LOAD - NO SETTINGS restores all but those program settings from a file, and
  172. EXIT terminates the session.
  173.  
  174.  
  175.   COIN MAIN MENU.
  176.  
  177. NEW creates a coin. The dialog asks for the coin value, the number of coins
  178. to make, and their denomination (US dollars, Euros, goats, whatever). See
  179. more about denominations in section VI. ERASE destroys a coin. Usually the
  180. only time you need to do this is when someone redeems a coin that you issued.
  181. STORE and FETCH move coins between a locale and the desktop. VERIFY checks
  182. on a coin with it's issuer. REISSUE replaces a coin with a new coin of
  183. equivalent value to prevent a double spend. DESIGN brings up a dialog for
  184. creating a new coin type or "denomination". See section VI for more about
  185. this.
  186.  
  187.  
  188.   SETTINGS MAIN MENU.
  189.  
  190. SELECT-OZ-SERVER chooses the hostname (or IP address) to reach an Oz server.
  191. When OZ becomes a fully distributed peer-to-peer network, this will go away.
  192. The REPUTATION-SERVER dialog chooses the Nym of the reputation server to which
  193. reputation reports will be sent. See "Coin icons" below for more about this.
  194. If you intend to operate a reputation service yourself, this dialog also
  195. specifies your report spooling directory, and a button to start and stop
  196. the service. See more about this in section VI.
  197.  
  198.  
  199.   HELP MAIN MENU.
  200.  
  201. ABOUT presents some version and author information. HELP: you're reading it
  202. now, of course.
  203.  
  204.  
  205.   NYM ICONS AND THEIR POP-UP MENU.
  206.  
  207. Nym icons are a shadow-figure head with name at the bottom.
  208. Your Nym icons have a thick white frame, whereas the Nyms of others do not.
  209. Also, under your currently active Nym, the name is enclosed in [Square
  210. Brackets]. Note that just as in the real world, names may not be unique.
  211.  
  212. Right-clicking a Nym icon pops a menu of the items NEW, SWITCH, ERASE,
  213. CHECK-REP, REP-OK, and REP-NG. NEW is how you create another Nym for 
  214. yourself. SWITCH is how you select a Nym to be the current one you are
  215. using. ERASE destroys a Nym. CHECK-REP sends a query to your reputation
  216. server that returns reputation info about the Nym. 
  217.  
  218. The two options REP-OK and REP-NG give you the opportunity to file a good
  219. or bad report on someone you deal with. This is part of the Oz Reputation
  220. Management System, and a very important thing in anonymous economics. Say you
  221. exchanged 40 Euros for Yen but when you tried to reissue the yen, they were
  222. already spent. 1) You right-click on any Nym and select REP-NG, 2) you click
  223. on Euros to total 40 (or the equivalent in Yen or gold or whatever), 3) you
  224. click on the Nym of the bad guy. DING! A negative report is sent to the
  225. reputation server containing the witness (you), the subject (Mr. Bad Guy),
  226. and the value of the transaction (40 EU). Likewise After the conclusion of a
  227. satisfatory transaction you should make a report, but selecting REP-OK instead.
  228.  
  229. If you drag a Nym onto a locale, you will enter the locale. If you drag your
  230. Nym out of a locale, you will leave that locale. if you drag someone elses Nym
  231. from a locale onto the Oz desktop, you will make a copy of their Nym. If you
  232. drag a Nym onto another Nym, the two will be compared for 'sameness'. By making
  233. copies of Nyms you deal with often, you can make sure you are dealing with the
  234. same Nym at a later time, not just one with the same name.
  235.  
  236.  
  237.   COIN ICONS AND THEIR POP-UP MENU.
  238.  
  239. Coin icons are an antique Roman gold piece with the denomination above, and
  240. value underneath.
  241.  
  242. Right-clicking a coin has all the same options as those in "COIN main menu"
  243. above except for DESIGN, but you won't have to deal with any coin-selection
  244. dialogs. If you drag a coin onto a locale, it will be removed from
  245. the desktop and stored in that locale. Likewise, you can drag a coin from a
  246. locale to the desktop, or from one locale to another.
  247.  
  248.  
  249.   LOCALE ICONS AND THEIR POP-UP MENU.
  250.  
  251. A locale is uniquely identified by its name. A locale icon is a Mollweide
  252. projection world map with its name above.
  253.  
  254. The locale pop-up menu (right-click) has lots of options. NEW creates a new
  255. locale. Enter makes you present at a locale. When you enter a locale, some cool
  256. stuff happens. See "Presence and talk windows" below. LEAVE removes you from a
  257. locale and collapses the presence window back into a locale icon. TALK toggles
  258. your talk window for a local where you are present and makes it possible for
  259. others at the locale to 'hear' what you 'say' there. LOOKUP will make a locale
  260. icon on your desktop for a named locale if it already exists, and FORGET will
  261. remove a locale icon (without actually erasing the locale itself). In this way
  262. you can control what locales you currently keep icons for on your desktop.
  263. FETCH-COINS and STORE-COINS give you a way to grab bunches of coins and move
  264. them between your desktop and a locale. EMPTY will transfer ALL coins in a
  265. locale to your desktop. ERASE destroys a locale. Any coins there will be
  266. moved to your desktop. VERIFY-COINS lets you batch a verification request for
  267. a bunch of coins in a locale.
  268.  
  269. If you drag your Nym onto a locale, you will enter the locale. If you drag your
  270. Nym out of a locale, you will leave that locale. if you drag someone elses Nym
  271. from a locale onto the Oz desktop, you will make a copy of their Nym for
  272. later comparison.
  273.  
  274.  
  275.   PRESENCE AND TALK WINDOWS.
  276.  
  277. When you enter a locale, it opens up into a window where you can see all the
  278. coins and Nyms present there, including yours. You can move coins between
  279. it and your desktop and others present there will see the coins appear and 
  280. disappear. You can see the coming and going of Nyms. One thing to be careful
  281. about is that if you switch Nyms while present at a local, it will be obvious
  282. to others that the two are the same person.
  283.  
  284. You can also listen to and participate in conversations there. For every Nym
  285. in a presence window, there is a smaller "talk" window titled with the name 
  286. of the locale and Nym. Whatever that Nym types into his talk window will
  287. be visible to all others present. Your talk windows are white, everyone 
  288. elses have a grey background. You can backspace in a talk window, even 
  289. through previous lines. Presence and talk windows, like the desktop window,
  290. can be resized and minimized in the usual ways.
  291.  
  292. You can drag and drop coins and Nyms among locales and the Oz desktop and
  293. something meaningful will generally happen. Read the individual sections for details.
  294.  
  295.  
  296.             VI - ADVANCED.
  297.  
  298.   DENOMINATIONS.
  299.  
  300. Denomination is the type of value represented by a coin. It may be a commodity
  301. like gold, or a complete abstraction without intrinsic value like US dollars,
  302. or a specific asset like a particular Ming vase. Most coins you encounter in
  303. Oz will be issued by some widely known Nym with a reputation for reliably
  304. issuing and redeeming currency. Most will be denominated in familiar national
  305. currencies. You will likely have other reasons to create your own coin types.
  306.  
  307. If someone in Oz makes you a loan, they are likely to ask you for an IOU coin.
  308. If you ran a storage business you could issue coins for stored assets so they
  309. could be traded in Oz (in the banking business this is called securitization), and so on.
  310.  
  311. You create and edit your denominations in the main menu COIN->DESIGN dialog.
  312. NAME is the coin type "12th Dynasty Ming Vase". The ISSUER is you, one of your
  313. Nyms. GOLD GMS is the nominal gold equivalent value which need not be terribly
  314. accurate, its only used for normalizing the values in reputation reports.
  315. SERIAL is the serial number of the next coin of the type to be issued. Click
  316. NEW and you're done. Click UPDATE to make any changes take effect.
  317.  
  318.  
  319.   REPUTATION SERVER SETTINGS.
  320.  
  321. In "Coin icons and their pop-up menu" You saw how to submit a reputation
  322. report on another Nym to indicate your satisfaction, or dis, with its
  323. outcome. Those reports are transmitted to some Nym you have selected to be
  324. your reputation server. If you are a Nym that runs a reputation server, you
  325. will use the SETTINGS->REPUTATION-SERVER dialog to turn your service on and off.
  326. You may also elect to run a separate application that uses reputation reports
  327. to maintain a dynamic website featuring a scrolling marquee of reputation
  328. into. SPOOL DIRECTORY is the filesystem directory on your local host to put the
  329. reports where that application can find them. Click START to kick things off.
  330.  
  331.  
  332.             VII - CAVEAT.
  333.         (Some Warnings, what this is NOT)
  334.  
  335. This is not ... something you want to trust your actual money with.
  336. This is ....... a demo and test of a novel approach to anonymous economics.
  337. This is not ... secure, strongly anonymous, encrypted, authenticated.
  338. This is ....... the GUI front-end to what could eventually be all of that.
  339.  
  340. There were several optimistic references to security and authentication in
  341. the material above. Disregard them completely. They apply to some time in the
  342. dim and distant future when this GUI becomes the front end to a truly secure,
  343. peer-to-peer distributed network, rather than a concept demonstration.
  344.  
  345. Several other things are still desperately needed to make this a practical
  346. environment. The automated escrow function described in the paper has not been
  347. implimented. There is no abilility to establish ownership or control access to
  348. a locale. Nyms are not authenticated and anyone can make up a Nym with any name.
  349. The 'comparison' feature currently does no more than compare names so it
  350. provides no real protection. Coins are not authenticated either so there is no
  351. real protection against counterfeiting either the issuer's Nym, or the coins
  352. themselves. Our paper specifies that the Oz environment is to be decentralized,
  353. fully distributed, peer-to-peer. But the current software works through a
  354. central server and won't scale up beyond a few dozen concurrent clients. We
  355. believe a functional anonymous environment should store coins and locales
  356. holographically using one of the well-known algorithms for distributed data
  357. storage, but at this stage, data storage depends on the central server.
  358. There is no encryption whatsoever of traffic, transactions, coins. So there is
  359. only the illusion of privacy and anonymity. If you get more than 15 or 20 Nyms
  360. in a locale, you will run into OS limitations on the number of windows in an
  361. app. Finally, this is alpha software less than 2 months old, and if there are
  362. no more bugs or issues in it, the devil will have to turn down his air
  363. conditioner and put on an extra sweater.
  364.  
  365. All that said, this is still a cool tool for experimenting with a novel
  366. approach to financial privacy and anonymous economics. If we can pull together
  367. some additional talent in the areas of encryption and P2P networking, we will
  368. set up an open source development project. Until then, we welcome any feedback,
  369. ideas, criticism, bug reports, whatever. But for now, we make no promises.
  370.  
  371.  
  372.             VIII - INSTALLATION.
  373.  
  374.   OUT OF THE BOX
  375.  
  376. The distribution is in the form of a single compressed file, Oz.zip.
  377. It is known to run under Windows 98, 2000, and XP. It will
  378. also likely work with ME and NT but hasn't been tested there. It will unpack
  379. into three directories PDE_CLIENT, PDE_SERVER, and REP_SERVER. You will want
  380. to make shortcuts on your windows desktop to OZ\PDE_CLIENT\pdenode.exe,
  381. OZ\PDE_SERVER\pde_server.exe, and OZ\REP_SERVER\repserver.exe .
  382.  
  383.  
  384.   THE CLIENT.
  385.  
  386. The client application pdenode.exe is your local node in the Oz 'network'.
  387. as distributed, it opens with the default Nym "J. Doe". The first thing you
  388. should do is make your own personal Nym(s) then erase Mr. "Doe". An INIT file
  389. in the PDE_CLIENT directory will remember your last Nym, config settings, 
  390. personal coin denominations, Oz desktop layout, and so on.
  391.  
  392. The default server hostname is set to localhost. Unless you have an Oz server running there, the client will initially timeout after a few seconds trying to contact it. Use the main menu SETTINGS->SELECT-OZ-SERVER to configure the
  393. hostname or IP address where an Oz server is running. Then the client will
  394. attempt to establish a connection to it.
  395.  
  396. You can run several clients at the same time on the same host, but you
  397. should make a separate client directory and init file (pde_data.ozc) for each
  398. one. Each one should use different Nyms. The same Nym should not appear on more
  399. than one client.
  400.  
  401. If you ever want to reset things to clear your client desktop and start over,
  402. you can do so by exiting the client and removing it's init file Pde_data.ozc .
  403. It will complain about the missing file on restart, but carry on.
  404.  
  405.  
  406.  
  407.   THE SERVER.
  408.  
  409. This experimental version of the Oz GUI requires a central server to handle
  410. storage of and concurrent access to coins and locales, and to act as a
  411. switchboard for message traffic between clients. If you are setting up yout own
  412. 'network' you must run the server on one of your hosts and configure all clients
  413. to look for their server on that host. Very simple, just execute it.
  414.  
  415. If you ever want to reset things to erase all coins and locales and start over,
  416. you can do so by exiting the server and removing it's init file Pde_data.ozs .
  417. It will complain about the missing file on restart, but carry on.
  418.  
  419.  
  420.   THE REPUTATION WEBSITE APP.
  421.  
  422. As already described, a client can make reputation reports and get reputation
  423. readings on other Nyms with a click or two. This depends on some client
  424. being configured as a reputation server. That client can also optionally run
  425. a separate application that maintains a dynamic website of reputation info
  426. updated from the flow of reputation reports it receives. This is completely
  427. separate from the basic reputation service that answers reputation queries
  428. from other Nyms.
  429.  
  430. This application was taylored for use in the proposed role-playing simulation
  431. experiment at DEFCON-12 where in addition to the website accessible to players,
  432. the display would be visible on a video projector in the room. Detailed 
  433. instructions on operating the thing have not been written, but here is a brief
  434. overview of it's features:
  435.  
  436. It accumulates reputation reports in an ascii data file. It can receive
  437. reputation reports in three ways. 1) reports forwarded from an Oz client node
  438. acting as a reputation server as files in a spooling directory. 2) reports
  439. manually entered thru a full-featured GUI. 3) Merging ascii report data files
  440. created by other instances of the same application. The report database can be
  441. searched and edited, traversed by time, subject Nym, or witness Nym. There
  442. is also Nym string completion to speed manual report entry. Play around with
  443. it. It should be fairly obvious.
  444.  
  445. As distributed, it comes with a sample reputation database of a couple hundred
  446. reports over 40 or so Nyms. You can clear it by removing the file
  447. Oz\REP_SERVER\Reputations.txt. To see the dymanically updated web page it generates, point your browser to Oz\REP_SERVER\Reputations.html.
  448.  
  449.  
  450.